Enqueue a new site scan

post

Authorizations

useroauth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

siteIdstringRequired

The unique id of the site

Body

application/json

topicstringRequired

The site topic ID to scan.

Responses

202

Site scan has been enqueued

application/json

objectstring · enumRequiredPossible values:

idstringRequired

The ID of the scan

statusstring · enumRequired

Status of a persisted site scan.

Possible values:

topicstring · nullableRequired

The site topic ID associated with the scan. It is null for scans that are not associated with a current topic in the site.

createdAtstring · date-timeRequired

startedAtstring · date-timeOptional

finishedAtstring · date-timeOptional

failureMessagestringOptional

Failure message for failed scans

post/orgs/{organizationId}/sites/{siteId}/scans

HTTPcURLJavaScriptPython

POST /v1/orgs/{organizationId}/sites/{siteId}/scans HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "topic": "text"
}

202

Site scan has been enqueued

{
  "object": "site-scan",
  "id": "text",
  "status": "pending",
  "topic": null,
  "createdAt": "2026-07-21T22:19:02.473Z",
  "startedAt": "2026-07-21T22:19:02.473Z",
  "finishedAt": "2026-07-21T22:19:02.473Z",
  "findings": {
    "low": 1,
    "medium": 1,
    "high": 1
  },
  "failureMessage": "text",
  "urls": {
    "location": "https://example.com"
  }
}