Ogiltig preferens


`type`	`https://docs.frem.sh/reference/api/errors/invalid-preference`
HTTP status	`400` Bad Request

Vad det betyder

Värdet preference i begärans innehåll är inte ett av de godkända värdena.

Det här är Forgejos egna aviseringsinställningar, så uppsättningen godkända värden är fast och motsvarar exakt Forgejos egen vokabulär:

Värde	Effekt
`enabled`	Ta emot all aviseringsmejl (Forgejos standard).
`onmention`	Ta emot mejl bara när du nämns uttryckligen.
`andyourown`	Ta emot mejl även för dina egna åtgärder.
`disabled`	Ta inte emot några aviseringsmejl.

Jämförelsen skiljer på stora och små bokstäver: onmention är giltigt, onMention och ONMENTION är det inte.

Vad du gör

Skicka ett av de fyra värdena ovan, skrivet med gemener.

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

Svarets form

Alla fel från fremforges API är 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."
}

Styr din felhantering på type, inte på title eller detail: de är skrivna för människor och kan formuleras om.

Ogiltig period Ogiltig principal-policy