Cancel Sandbox Template build
PreviewCancel queued or running build work and clean up its disposable resources.
/v1/sandbox-template-builds/{id}/cancelSee authentication for credentials and permissions.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Prefixed public identifier
Responses
200Success
Success
Tenant-scoped build attempt, retained inputs, bounded output, and provider artifact. Management credentials are stored separately and never appear in this record.
object
Immutable template revision created by applying this artifact, if applied.
Disposable installation compute identifier or its persisted submission name.
Whether cancellation was accepted; stale worker saves cannot erase this request.
Whether provider resources still require confirmed cleanup or reconciliation.
Time this build attempt was accepted.
Bounded failure explanation, absent when no failure has been recorded.
Unique build attempt identifier.
UTF-8 execution-output tail, bounded to 32 KiB.
Original immutable installation and verification inputs.
object
POSIX shell install script, 1–32768 UTF-8 bytes. Keep secrets out of it.
Optional bounded, author-supplied Markdown captured from the builder.
Source revision to guard against concurrent template edits.
Total build deadline, including installation and fresh verification, in seconds.
Optional check run after installation and again in fresh snapshot compute.
Parent template whose immutable source revision supplied the build configuration.
Provider snapshot identifier, present once the artifact has been resolved.
Deterministic provider artifact name used to reconcile uncertain submissions.
Submission time used when reconciling a snapshot response lost in transport.
Up to 16 KiB of author-supplied Markdown, presented as untrusted reference data.
Exact source spec; no runtime credentials or workspace are attached.
object
Reproducible commands run when physical compute is initialized.
object
Ordered commands replayed when creating or recovering physical compute.
Requested isolation policy; resolution supplies an honest target default.
object
Whether the runtime may widen containment after Session creation.
Filesystem mutation boundary for command execution.
object
Absolute roots the runtime may mutate; empty means provider default.
Isolation mechanism the provider must supply.
Idle lifecycle policy controlled by Everruns.
object
How long a paused Sandbox is kept, counted from its last activity,
before Everruns deletes it with its files. The Session stays; its next
Sandbox call provisions a fresh one. null keeps paused Sandboxes
until their Session is deleted.
Action Everruns requests after the idle interval.
Inactivity interval before applying idle_action.
Provider-neutral target plus its concrete adapter binding.
object
Credential/transport binding for a registered machine target.
Provider credential source. User and Agent bindings are resolved to an exact virtual user when the Session starts; organization bindings also pin the exact connection.
object
Exact connection for organization grants, which may have several accounts for one provider.
Identity scope from which the provider credential is resolved.
Exact virtual-user owner for user, Agent, and organization grants.
Provider-neutral target class.
Provider-owned, non-secret configuration. Credentials are references, never values in this object.
object
Concrete adapter for target kinds with more than one implementation.
Immutable Sandbox Template revision this specification was copied from. The specification remains complete so Agent snapshots are portable and later template revisions cannot change an existing snapshot.
Persisted lifecycle state; inspect cleanup_pending before applying a Ready build.
Current execution or cleanup step.
Time of the last persisted build update.
Disposable fresh-snapshot verification compute identifier or submission name.
Example
{ "applied_revision_id": "sbxtplrev_01933b5a000070008000000000000002", "builder_id": "550e8400-e29b-41d4-a716-446655440001", "cancel_requested": false, "cleanup_pending": false, "created_at": "2026-10-29T00:00:00Z", "error": "Command failed with exit code 23", "id": "sbxbuild_01933b5a000070008000000000000001", "logs": "HTTPie 3.2.4\nVerification passed\n", "request": { "build_network": { "mode": "deny" }, "install_script": "python -m venv /home/daytona/.venvs/devtools\n/home/daytona/.venvs/devtools/bin/pip install httpie==3.2.4", "metadata_path": "/home/daytona/.everruns/sandbox.md", "source_revision_id": "sbxtplrev_01933b5a000070008000000000000001", "timeout_seconds": 600, "verification_command": "/home/daytona/.venvs/devtools/bin/http --version" }, "sandbox_template_id": "sbxtpl_01933b5a000070008000000000000001", "snapshot_id": "550e8400-e29b-41d4-a716-446655440000", "snapshot_name": "everruns-build-01933b5a000070008000000000000001", "snapshot_requested_at": "2026-10-29T00:00:00Z", "software_notes": "# Installed tools\n- HTTPie 3.2.4", "source_spec": { "containment": { "escalation": "never", "level": "none", "network": { "mode": "deny" } }, "durability": "checkpointed", "lifecycle": { "delete_after_seconds": 259200, "idle_action": "checkpoint_and_stop", "idle_after_seconds": 300 }, "target": { "connection_id": "conn_01933b5a000070008000000000000001", "credential": { "connection_id": "00000000-0000-0000-0000-000000000002", "source": "none", "virtual_user_id": "00000000-0000-0000-0000-000000000001" }, "kind": "host", "provider": "daytona" } }, "status": "queued", "step": "installing", "updated_at": "2026-10-29T00:01:00Z", "verification_sandbox_id": "550e8400-e29b-41d4-a716-446655440002"}