Skip to main content

Authentication required

typehttps://docs.frem.sh/reference/api/errors/authentication-required
HTTP status401 Unauthorized

What it means

Authentication is missing, or the credential was rejected.

Example detail messages returned with this error:

  • Missing or malformed Authorization header.

What to do

No credential was presented. Send Authorization: token <ffp_...> or a Bearer JWT.

Response shape

All fremforge API errors are RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/authentication-required",
  "title": "Unauthorized",
  "status": 401,
  "detail": "..."
}

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