Skip to main content
DELETE
Delete a snapshot.

Authorizations

Authorization
string
header
required

Opaque instabox access token (1 hour). Refresh with /v1/auth/refresh (refresh token valid 30 days, rotates on use).

Headers

Idempotency-Key
string
required

Client-generated key, 1-200 printable ASCII characters, scoped to the user. Same key and same method+path+body returns the original response; same key with a different request returns 409 idempotency_conflict. Records are kept for 7 days.

Required string length: 1 - 200
Pattern: ^[\x21-\x7e]+$
X-Confirm-Delete
string

Guard against deleting the wrong resource: the ID or the exact name of the sandbox or snapshot being deleted. When sent, any other value (empty, another resource's name or ID, or the header twice) is 409 delete_confirmation_required and nothing is deleted; the Idempotency-Key can then be reused. A sandbox delete with an API key created on or after the server's confirmDeleteKeysFrom cutover must send it (without it: the same 409, naming the ID to send); otherwise, without the header, the delete proceeds as before (an API key's response then carries a Warning header). The instabox CLI, the SDKs, the hosted MCP server and the dashboard send it.

Path Parameters

id
string
required

Snapshot ID (sn_, or im_ for older snapshots, + 26 lowercase base32 characters).

Response

Deleted.