Skip to main content

User identity required

typehttps://docs.frem.sh/reference/api/errors/user-identity-required
HTTP status403 Forbidden

What it means

The credential is valid but not permitted to do this.

Example detail messages returned with this error:

  • Deployment approval requires a user identity (SSO/OAuth bearer or operator token), not a plain PAT — the reviewer allowlist + self-approve guard need a known user.

What to do

Supply the missing user_identity value and retry.

Response shape

All fremforge API errors are RFC 9457 problem+json:

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

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