Delete a site
const url = 'https://qinto-api.blotout.io/teams/7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9/domains/3f2a9c81-5d47-4e0b-8c66-91b2a7f04d15';const options = { method: 'DELETE', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"confirmation":"shop.example.com"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request DELETE \ --url https://qinto-api.blotout.io/teams/7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9/domains/3f2a9c81-5d47-4e0b-8c66-91b2a7f04d15 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "confirmation": "shop.example.com" }'Deletes a site. It leaves the team at once and stops serving once the change reaches it.
How it works
The site leaves the team as soon as the call succeeds, but it keeps serving until the change reaches it. edgeSettled reports whether that has happened: false means it is still serving and it retries on its own, so no action is needed — but do not read the response as proof it has stopped. Its resources are kept for 14 days and torn down after that. The site’s hostname stays reserved permanently, so it cannot be re-created at the same address. To guard against deleting the wrong site, confirmation must equal the site’s hostname, compared without regard to case or surrounding spaces.
Required permissions
domain:deleteon all domains, or on the addressed domain when its id is in the route
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Unique id (UUID) of the team that owns the addressed resources, as shown in the team settings on the Blotout platform.
Example
7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9Unique id (UUID) of the team that owns the addressed resources, as shown in the team settings on the Blotout platform.
Unique id (UUID) of the site, as returned by the create and list operations.
Example
3f2a9c81-5d47-4e0b-8c66-91b2a7f04d15Unique id (UUID) of the site, as returned by the create and list operations.
Request Bodyrequired
Section titled “Request Bodyrequired”Confirmation that the right site is being deleted.
Confirmation that the right site is being deleted.
object
The site’s hostname, typed back to confirm the deletion. Compared without regard to case or surrounding spaces.
Example
shop.example.comResponses
Section titled “Responses”The site was deleted.
object
Always true: the site has left the team.
Whether the site’s worker already knows it is deleted. False means it is still being told; no action is needed.
Example
{ "deleted": true, "edgeSettled": true}invalid_params — A path parameter failed validation (for example a malformed UUID); details pinpoints the offending parameter. invalid_body — The JSON body is unparseable or failed schema validation; details pinpoints the offending fields when the body could be parsed.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Field-level validation errors: a tree keyed by input property, each node carrying an errors array of human-readable messages. Render it to help the caller correct the request.
object
Example
{ "error": "invalid_params", "details": { "errors": [], "properties": { "teamId": { "errors": [ "Invalid UUID" ] } } }}unauthenticated — The Authorization: Bearer token is missing, malformed, or no longer valid. Generate a team API token or obtain a new OAuth access token.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "unauthenticated"}forbidden — The bearer credential lacks the required permission or belongs to another team, or its user lacks the organization role a developer operation needs. Update its policies, use a credential bound to the addressed team, or ask an organization owner for the role; message states the reason when one is known.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Human-readable reason for this specific failure, intended for display — do not parse it programmatically.
Example
{ "error": "forbidden", "message": "The Cloudflare API token is invalid or expired."}not_found — The addressed resource does not exist within this team; check the id and retry.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "not_found"}storage_linked — The site is part of a storage link configuration, or its unlink has not reached every worker yet, so deleting it would leave another site bound to storage that no longer exists. Remove it from the configuration and wait for the sync to settle, then retry.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "storage_linked"}invalid_confirmation — The typed confirmation did not match the site’s hostname, so nothing was deleted.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Human-readable reason for this specific failure, intended for display — do not parse it programmatically.
Example
{ "error": "invalid_confirmation", "message": "The Cloudflare API token is invalid or expired."}internal — Unexpected server error. Nothing is guaranteed to have been persisted; idempotent operations are safe to retry.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "internal"}