--- title: "Delete a site" method: DELETE path: "/sites/{id}" tags: ["Sites"] --- # Delete a site `DELETE /sites/{id}` ## Request - Base URL: `https://statable.com/api/v1` - URL: `https://statable.com/api/v1/sites/{id}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Owner only — an admin may edit the site but not delete it — and it really deletes: the site plus its goals, hostnames, blocklists and import jobs, with its ClickHouse data removed asynchronously. An admin or a member gets 403 `not_site_owner` — there is no API equivalent of the dashboard's "remove my access". Every deletion is first recorded in an off-database journal so that a restore from backup cannot bring the site back; when that journal cannot be written the deletion is refused with 503 `deletion_unavailable` and nothing is deleted — retry later. ## Response `204` Deleted. ## Other responses - `401`: Missing/malformed/invalid/revoked bearer token (`unauthorized`), or a key past its expiry (`key_expired`; the message names the expiry time). - `403`: `insufficient_scope`, `key_not_scoped`, or `not_site_owner`. - `404`: `write_disabled` or `unknown_site`. - `429`: Hourly account (default 2000/h) or per-key (default 600/h) limit hit (`rate_limited`). Retry after the `Retry-After` seconds. The X-RateLimit-* headers report the window that tripped (account on an account limit). - `500`: Unexpected server error (`internal`). Report it with the `request_id` from the body or the X-Request-ID header: it is what lets the exact log entry be found, and without it a 500 can only be matched by guessing at a time window. - `503`: `deletion_unavailable` — the deletion journal could not be written, so nothing was deleted. Retry later. --- [API](https://skmtc.dev/statable/apis/statable-stats-api.md) - [All operations](https://skmtc.dev/statable/apis/statable-stats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/statable/apis/statable-stats-api/revisions/352b6d47c186?raw)