Plateforme3 min

Préférences de notification

Lire et modifier les préférences de notification de l'utilisateur authentifié.

Les préférences de notification appartiennent à l’utilisateur authentifié et valent pour toutes ses organisations. Les deux endpoints exigent le scope OAuth profile.

Lire les préférences

GET /api/public/v1/users/me/notification-preferences
Authorization: Bearer ACCESS_TOKEN
{
  "digestFrequency": "Weekly",
  "newsletter": true
}

digestFrequency accepte Daily, Weekly, Biweekly, Monthly ou Never. Un utilisateur qui n’a jamais modifié ses préférences est en Daily, et l’abonnement à la newsletter vaut true par défaut.

Modifier les préférences

La mise à jour est partielle. Un champ omis conserve sa valeur actuelle.

PATCH /api/public/v1/users/me/notification-preferences
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "digestFrequency": "Monthly",
  "newsletter": false
}

Un champ inconnu, une fréquence invalide ou une valeur non booléenne pour newsletter renvoient 400 Bad Request.