Skip to main content

Invalid scopes

typehttps://docs.frem.sh/reference/api/errors/invalid-scopes
HTTP status400 Bad Request

What it means

The request was malformed, or a field failed validation.

Example detail messages returned with this error:

  • At least one scope is required.
  • Unknown scope: {s}.
  • Scope ‘{s}’ is operator-only and cannot be granted to a client.

What to do

One or more requested scopes are not in the vocabulary. Scope names are plural (orgs:read, exports:write).

Response shape

All fremforge API errors are RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/invalid-scopes",
  "title": "Bad Request",
  "status": 400,
  "detail": "..."
}

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