Skip to main content

Insufficient scope

typehttps://docs.frem.sh/reference/api/errors/insufficient-scope
HTTP status403 Forbidden

What it means

The credential is valid but not permitted to do this.

Example detail messages returned with this error:

  • Token lacks required scope ‘{scope}’.

What to do

The token is valid but lacks the scope this endpoint requires. Mint a token with the scope named in the endpoint’s security block.

Response shape

All fremforge API errors are RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/insufficient-scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "..."
}

Branch on type, not on title or detail - those are human-readable and may be reworded.