Delete a site
Deletes the site. Its agents and connectors are detached (their `siteId`/`site_id` cleared), never deleted: they become org-level/unassigned. Returns the id and a deleted flag. An organization keeps at least one site: deleting its only one is refused with `409`.
Authorization
ApiKeyAuth A WorkOS org-scoped API key, created from the dashboard's organization settings page. Identifies the tenant every read and write is scoped to. Missing, malformed, unknown, revoked, expired, or non-organization-owned keys all return 401 (no distinction, so the response can't be used to probe which keys or org ids exist).
In: header
Path Parameters
The site id (prefixed site_). A site id that isn't yours is a 404, same as any other cross-tenant id.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X DELETE "https://example.com/api/v1/sites/string"{ "data": { "id": "site_01kvnwmagvf27rc9cze5rm9e1r", "deleted": true }}Update a site
Replaces the site's `name`, `platform`, and `url` together, and optionally patches its AI-assistant-context fields (`siteInformation`, `toneOfVoice`, `vertical`). This does not accept a partial `name`/`platform`/`url` update: always send all three.
List a site's agents
Returns every agent on this site (soft-deleted agents excluded), newest first, each with its current champion version number.