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. |
Sandboxes And Scheduling
| Code | Description |
|---|
sandbox_not_found | The referenced sandbox does not exist or is not visible to the caller. |
sandbox_not_ready | Sandbox 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.
