Errors

Status codes and the error object.

Preview documentation. Details may change before the API is released.

Errors use standard HTTP status codes and a JSON body.

{
  "error": {
    "code": "validation_failed",
    "message": "One or more fields are invalid.",
    "request_id": "req_123"
  }
}

Include request_id when you contact support.

Status codes

Status	Meaning
`400`	The request is malformed or a field is invalid
`401`	The key is missing, invalid or revoked
`403`	The key lacks the scope for this request
`404`	The resource does not exist in your workspace
`409`	The request conflicts with current state, or an idempotency key was reused with a different body
`422`	The request is well formed but cannot be processed
`429`	A rate limit was reached
`500`	An error on our side. Retry with the same idempotency key
`503`	The service is in maintenance. Retry after the `Retry-After` interval

Error codes shown here are illustrative in the preview and will be listed in full before release.