Chaos.beta
Browse the API reference

Scans

Queue a scan

Queue an immediate re-scan of one tracked domain. Returns 202 — large programs continue in the background. Requires a key with the `write` scope.

POSThttps://chaos.thescope.top/api/v1/scansscope: write

Write scope required

This endpoint changes state, so the token must carry the write scope. Read-only keys get a 403 insufficient_scope.

Body

domainstringrequired

Root domain to re-scan.

Example response

200 application/json
{ "data": { "domain": "lovable.app", "status": "queued" } }

Errors

400invalid_bodyA POST body was missing or was not valid JSON.
400invalid_domainThe supplied domain is not a valid root domain.
400invalid_queryA required query parameter was missing or too short.
400invalid_idA path id was not a UUID.
401missing_tokenNo Authorization or X-API-Key header was sent.
401invalid_tokenThe token is malformed or unknown.
401revoked_tokenThe token was revoked by its owner.
403insufficient_scopeA write endpoint was called with a read-only key.
404not_foundThe domain, platform, scan or endpoint does not exist.
405method_not_allowedThe HTTP verb is not supported on that path.
500query_failedA database query failed while serving the request.
500server_errorAn unexpected error occurred.

Full catalogue with fixes on the errors page.

Previous

Get one scan

Next

Full re-scan

POSTTry it

Kept in this browser tab only and sent straight to this API.

https://chaos.thescope.top/api/v1/scans
curl -X POST "https://chaos.thescope.top/api/v1/scans" \
  -H "Authorization: Bearer chs_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{}'