Skip to main content

Tenant scope required

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

What it means

The credential is valid but not permitted to do this.

Example detail messages returned with this error:

  • Token must be tenant-scoped.
  • Token must be tenant-scoped.
  • Token must be tenant-scoped.

What to do

The token is not scoped to a tenant. Mint an org-scoped token in Org admin -> API tokens; a user-scoped token cannot reach org resources.

Response shape

All fremforge API errors are RFC 9457 problem+json:

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

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