Scans

Submit a new scan.

Queue a scan of the given URL. Runs asynchronously on the scans worker (inline in tests). Rate limit: 10 scans/day per client IP when unauthenticated; 100 scans/day per key when Authorization: Bearer ak_… is presented. Mint a key via POST /api/v1/keys.

post/api/v1/scans

Request

  • Base URL: https://agentdisco.io
  • URL: https://agentdisco.io/api/v1/scans
  • Auth: none declared

Request body

urlstring required

Response

Scan accepted.

idstring uuid required

UUID of the new scan.

statusstring required

One of queued|running|completed|failed|cancelled.

statusUrlstring required

Poll this URL for current status.

resultUrlstring required

Public report page URL for the scanned host.

gradestring nullable

A..F letter grade once computed; null while queued/running.

scoreinteger nullable

0..100 score once computed; null while queued/running.

Changes

No recorded changes to this operation across all 1 revision of this API.