Hanzo AI
OpenapiSandbox

Delete sandbox

Ends a sandbox and releases the compute behind it. Answers 204. ENDING IS NOT STOPPING.

DELETE /v1/sandbox/{id}

Addresshttps://api.hanzo.ai/v1/sandbox/{id}
MethodDELETE
Operationdelete_sandbox_by_id
AuthAuthorization: Bearer $HANZO_API_KEY

Ends a sandbox and releases the compute behind it. Answers 204.

ENDING IS NOT STOPPING. This releases the resource: the pod goes and anything only inside it goes with it. To end what a sandbox is RUNNING while keeping the sandbox — the checkout, the logs, the half-written file — the verb is POST /v1/sandbox/stop.

?purge=1 additionally removes the record, so the sandbox stops being listed at all rather than being listed as ended.

Request

2 fields.

FieldInTypeRequiredDescription
idpathstringyesID is the sandbox to end, from the path.
purgequerystring

Response

StatusBodyMeaning
204no content

Failure carries the platform error shape — see Errors.

Examples

hanzo sandbox rm <id>

Sandbox API · All Hanzo APIs · Interactive reference

How is this guide?

On this page