Sites and scans
Sites, manual scans, domain verification, monitoring mode, the profile and the overview.
| Method | Path | Needs | Returns |
|---|---|---|---|
| POST | /sites | site.create | 201 site; the url is normalized to its origin |
| GET | /sites | site.read | paginated |
| GET | /sites/:siteId | site.read | site |
| POST | /sites/:siteId/archive | site.delete | 204 |
| PATCH | /sites/:siteId/monitoring | site.update | { usageMode?, scheduledAiReview?, aiChangeVerification? } |
| GET | /sites/:siteId/verification | site.read | verified, method, the token and how to publish it |
| POST | /sites/:siteId/verification/check | site.update | { method: DNS_TXT | WELL_KNOWN | HTML_META } |
| POST | /sites/:siteId/scans | scan.start | 202 { scan, joinedExistingScan } |
| GET | /sites/:siteId/scans | scan.read | paginated |
| GET | /scans/:scanId | scan.read | scan with steps[] and coverage |
| GET | /sites/:siteId/profile | site.read | every knowledge domain, with confidence and provenance |
| GET | /sites/:siteId/live-profile | site.read | what the last live scan saw, area by area |
| GET | /sites/:siteId/overview | site.read | the App Overview read model |
| GET | /sites-health | site.read | per-site health for lists |
| GET | /activity?siteId= | activity.read | paginated stream of meaningful events |
One scan runs per site at a time; a second request joins the running one and says so. The organization’s concurrency limit and the per-site cooldown are enforced on the server and answered with SCAN_COOLDOWN or TOO_MANY_ACTIVE_SCANS. Manual live-site scans cost no credits on paid plans.
Something here wrong, missing or out of date? Tell us and we will fix the page.