Error Responses

All errors return a consistent JSON structure:

{
  "error": {
    "code": "AGENT_NOT_FOUND",
    "message": "The requested agent does not exist or is not accessible",
    "request_id": "req_01HX..."
  }
}

Common error codes

Code	HTTP Status	What it means
`AUTH_INVALID_CREDENTIALS`	401	Wrong `client_id` or `client_secret`
`AUTH_AGENT_REVOKED`	401	Agent has been permanently revoked
`AUTH_AGENT_SUSPENDED`	403	Agent is suspended
`POLICY_SCOPE_DENIED`	403	Policy doesn’t allow the requested scope
`AGENT_NOT_FOUND`	404	Agent doesn’t exist in your workspace
`POLICY_NOT_FOUND`	404	Policy doesn’t exist
`VALIDATION_ERROR`	400	Request body failed validation
`RATE_LIMIT_EXCEEDED`	429	Too many requests — check `Retry-After` header

Request IDs

Every response includes an X-Request-ID header. Include this in any support request.

Tokens API Common Issues

​Common error codes

​Request IDs

Common error codes

Request IDs