authorization_failed

Errors · authorization_error

HTTP 403 · type authorization_error

Key lacks scope for this operation.

When it fires

Restricted keys (rk_…) and OAuth tokens have explicit scopes. The operation you requested is not in the granted set.

Recovery

Review the key's or token's scopes in the dashboard. For OAuth, re-run the consent flow with broader scopes.

Example response

JSON
{
  "error": {
    "type": "authorization_error",
    "code": "authorization_failed",
    "message": "Key lacks scope for this operation.",
    "doc_url": "https://docs.chronapilot.com/errors/authorization-failed",
    "request_id": "req_1A2b3C4d5E6f"
  }
}