API Error Catalog

Every non-2xx API response carries an ErrorResponse body with a human-readable error message and a stable machine-readable code from the catalog below. Responses may also include error_detail, a request_id for support correlation, and build_id for template-build failures.

The spec does not yet maintain per-code descriptions, so the descriptions below are auto-generated summaries derived from the code identifiers. The code list itself is the contract.

Authentication And Accounts

Code	Description
`unauthorized`	Unauthorized.
`auth_failed`	The auth operation failed.
`auth_locked`	Auth locked.
`auth_proxy_error`	An auth proxy error occurred.
`auth_proxy_unavailable`	The auth proxy is currently unavailable; retry later.
`invalid_auth_redirect`	Invalid auth redirect.
`invalid_oauth_provider`	Invalid oauth provider.
`captcha_required`	Captcha required.
`captcha_failed`	The captcha operation failed.
`captcha_unavailable`	The captcha is currently unavailable; retry later.
`disposable_email`	Disposable email.
`signup_rate_limited`	Too many signup attempts; retry after the rate-limit window.
`oauth_rate_limited`	Too many oauth attempts; retry after the rate-limit window.
`email_action_rate_limited`	Too many email action attempts; retry after the rate-limit window.
`email_not_verified`	Email not verified.
`account_deleted`	Account deleted.
`operator_required`	Operator required.
`account_not_found`	The referenced account does not exist or is not visible to the caller.
`account_not_soft_deleted`	Account not soft deleted.
`account_hard_delete_active_resources`	Account hard delete active resources.

Machines And Scheduling

Code	Description
`machine_not_found`	The referenced machine does not exist or is not visible to the caller.
`machine_not_ready`	Machine not ready.
`capacity_exceeded`	The request exceeds the capacity limit.
`no_eligible_runtime_host`	No eligible runtime host.
`same_host_required`	Same host required.
`transition_in_progress`	Transition in progress.
`transition_conflict`	The request conflicts with the current transition state.

Snapshots

Code	Description
`snapshot_not_found`	The referenced snapshot does not exist or is not visible to the caller.
`snapshot_in_use`	Snapshot in use.
`incompatible_snapshot`	Incompatible snapshot.
`rebuild_required`	Rebuild required.

Templates And Builds

Code	Description
`template_not_found`	The referenced template does not exist or is not visible to the caller.
`template_build_not_found`	The referenced template build does not exist or is not visible to the caller.
`template_name_claim_not_found`	The referenced template name claim does not exist or is not visible to the caller.
`build_error`	A build error occurred.

Agent Deployments

Code	Description
`agent_deployment_not_found`	The referenced agent deployment does not exist or is not visible to the caller.
`agent_deployment_version_not_found`	The referenced agent deployment version does not exist or is not visible to the caller.
`agent_run_not_found`	The referenced agent run does not exist or is not visible to the caller.
`agent_service_instance_not_found`	The referenced agent service instance does not exist or is not visible to the caller.
`agent_deployment_name_conflict`	The request conflicts with the current agent deployment name state.
`agent_deployment_idempotency_mismatch`	Agent deployment idempotency mismatch.
`agent_deployment_invalid_config`	Agent deployment invalid config.
`agent_deployment_invalid_state`	Agent deployment invalid state.

Volumes

Code	Description
`volume_beta_restriction`	Volume beta restriction.
`volume_invalid_mount_path`	Volume invalid mount path.
`volume_overlapping_mounts`	Volume overlapping mounts.
`volume_backend_capability_unsupported`	Volume backend capability unsupported.
`volume_quota_exceeded`	The request exceeds the volume quota limit.
`volume_mount_credential_issue_failed`	The volume mount credential issue operation failed.
`volume_backend_unavailable`	The volume backend is currently unavailable; retry later.
`volume_stale_revision`	Volume stale revision.
`volume_busy`	Volume busy.
`volume_read_only`	Volume read only.
`volume_limit_exceeded`	The request exceeds the volume limit.

Execution And Files

Code	Description
`file_upload_error`	A file upload error occurred.
`exec_timeout`	The exec operation timed out.
`exec_failed`	The exec operation failed.
`file_error`	A file error occurred.

Quotas And Rate Limits

Code	Description
`QUOTA_EXCEEDED`	The request exceeds the quota limit.
`rate_limit_exceeded`	The request hit a rate limit; respect `Retry-After` before retrying.

General

Code	Description
`invalid_request`	Invalid request.
`database_error`	A database error occurred.
`not_implemented`	Not implemented.
`feature_unavailable`	The feature is currently unavailable; retry later.
`internal_error`	An internal error occurred.

Error Codes - CLI exit codes, the CLI JSON error envelope, and edge/preview error anchors.
REST API Reference - per-endpoint error responses, rendered from the same specs/openapi.yaml.

Python SDK

Python SDK objects

TypeScript SDK

CLI

Platform reference

Authentication And Accounts

Machines And Scheduling

Snapshots

Templates And Builds

Agent Deployments

Volumes

Execution And Files

Quotas And Rate Limits

General

​Authentication And Accounts

​Machines And Scheduling

​Snapshots

​Templates And Builds

​Agent Deployments

​Volumes

​Execution And Files

​Quotas And Rate Limits

​General

​Related

Authentication And Accounts

Machines And Scheduling

Snapshots

Templates And Builds

Agent Deployments

Volumes

Execution And Files

Quotas And Rate Limits

General

Related