Naar de hoofdinhoud

Ongeldige voorkeur

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

Wat het betekent

De waarde van preference in de body van het verzoek is niet een van de geaccepteerde waarden.

Dit zijn de eigen meldingsinstellingen van Forgejo, dus de set geaccepteerde waarden ligt vast en komt exact overeen met de woorden die Forgejo zelf gebruikt:

WaardeEffect
enabledAlle meldingsmail ontvangen (standaard in Forgejo).
onmentionAlleen mail ontvangen als je expliciet wordt genoemd.
andyourownOok mail ontvangen over je eigen acties.
disabledGeen meldingsmail ontvangen.

Hoofdletters tellen mee: onmention is geldig, onMention en ONMENTION niet.

Wat je kunt doen

Stuur een van de vier waarden hierboven, in kleine letters.

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

Vorm van het antwoord

Alle API-fouten van fremforge zijn 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."
}

Baseer je logica op type, niet op title of detail: die zijn bedoeld voor mensen en kunnen anders worden geformuleerd.