Zum Hauptinhalt springen

Ungültige Einstellung

typehttps://docs.frem.sh/reference/api/errors/invalid-preference
HTTP-Status400 Bad Request

Was das bedeutet

Der Wert preference im Anfragekörper ist keiner der zulässigen Werte.

Das sind native Benachrichtigungseinstellungen von Forgejo, daher ist die Menge der zulässigen Werte fest und entspricht genau dem Vokabular von Forgejo:

WertWirkung
enabledAlle Benachrichtigungsmails erhalten (Standard von Forgejo).
onmentionMails nur erhalten, wenn du ausdrücklich erwähnt wirst.
andyourownMails auch für deine eigenen Aktionen erhalten.
disabledKeine Benachrichtigungsmails erhalten.

Groß- und Kleinschreibung zählt: onmention ist gültig, onMention und ONMENTION sind es nicht.

Was du tun kannst

Sende einen der vier Werte oben, kleingeschrieben.

curl -X PATCH \
  -H "Authorization: Bearer $FREMFORGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"preference":"onmention"}' \
  https://frem.sh/_app/api/v1/orgs/<org>/members/<login>/forgejo-mail

Form der Antwort

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

{
  "type": "https://docs.frem.sh/reference/api/errors/invalid-preference",
  "title": "Bad Request",
  "status": 400,
  "detail": "preference must be one of: enabled, onmention, andyourown, disabled."
}

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