User identity required
type | https://docs.frem.sh/reference/api/errors/user-identity-required |
| HTTP status | 403 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.