Error Handling

Errors follow a consistent JSON structure.

Error Envelope

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "The field accountId is required.",
    "details": [
      {
        "field": "accountId",
        "issue": "required"
      }
    ],
    "requestId": "req_A3f28d"
  }
}

Common Status Codes

• 400 Invalid input
• 401 Invalid or missing credentials
• 403 Forbidden scope or workspace mismatch
• 404 Resource not found
• 409 Conflict
• 429 Rate limit exceeded
• 500 Internal server error

Log and surface requestId when opening support tickets.

Related Docs

• Authentication
• Rate Limits
• API Reference