Zum Hauptinhalt springen

Kein Principal

typehttps://docs.frem.sh/reference/api/errors/no-principal
HTTP-Status403 Forbidden

Was das bedeutet

Die Anfrage war authentifiziert, aber der aufrufende Nutzer ließ sich keinem Forgejo-Konto zuordnen – es gibt also keine Identität, gegen die die Inhaberschaft geprüft werden könnte.

Die API lehnt hier ab, statt einen Inhaber zu raten. Eine Ressource, die der falschen Nutzer-ID zugeordnet ist, kann ihr wirklicher Inhaber nicht sehen, und das ist schlimmer als eine klare Ablehnung.

Beispiele für detail-Meldungen, die mit diesem Fehler zurückkommen:

  • Could not resolve the calling user.

Was du tun kannst

Meist ist es ein Token, dessen Nutzer inzwischen umbenannt oder entfernt wurde. Führe fremforge auth login erneut aus; hält es an, schreib an support@frem.sh und nenne die Token-ID aus fremforge auth tokens list – nie das Token selbst.

Form der Antwort

Alle Fehler der fremforge-API sind RFC 9457 problem+json:

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

Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.