Delete a sandbox template
Deletes one of your organization's templates, in any state, and frees its place in the organization's template limit. A create that names the template is refused within a few seconds, once the API's routers have taken the change. A create accepted before that may still start while it waits for capacity (its waitSeconds). Sandboxes already created from the template keep running until they end, paused ones included. A built-in template answers 403 TEMPLATE_BUILTIN. Repeating a delete answers 404. A 503 SERVICE_UNAVAILABLE means the delete was not confirmed and may have been applied: repeat it, and a 404 NOT_FOUND then means it was.
Required permission
Requires the sandboxes.template_write permission. See Permissions for the roles and API key permissions that include it.
Command line
The orl CLI wraps this endpoint:
Guided workflow: orl sandbox template delete
orl sandbox template delete <template-id>apiKeyAuthorizationBearer <token>OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).
templateId*stringThe template is deleted
curl -X DELETE 'https://api.openrelay.inc/v1/sandbox-templates/string'Get a sandbox template GET
Returns a sandbox template and the state of its builds. Use the template's id to create sandboxes after its build is ready. A failed template's failure says why the last attempt of its build failed.
Get the organization's sandbox network policy GET
Returns the organization's sandbox network layer, defaults and version, plus the members and API keys with their own policy layers. Send the bundle's version as expectedVersion on a write. Every layer is a ceiling on the sandboxes created under it. Network policy access must be enabled for the organization. Host egress, DNS and bandwidth enforcement is not yet available. Creates requiring an unsupported restriction return 503 NETWORK_POLICY_UNSUPPORTED. Only the organization layer's preview source restrictions are enforced. Host policy updates are not pushed to running sandboxes. The router applies updated organization preview restrictions on each new request, including previews of existing sandboxes, after receiving the new policy version.