(POST-V1) The caller's per-type channel preferences.
GET
/notifications/preferences
const url = 'https://api.gospl.example/v1/notifications/preferences';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.gospl.example/v1/notifications/preferences \ --header 'Authorization: Bearer <token>'POST-V1 — v1 has no opt-out; all types mandatory. Documented for future.
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”OK
Media type application/json
Array<object>
object
type
required
Seed registry; grows per feature. See spec §2.
string
channels
required
Array<string>
mandatory
Read-only hint — if true, channels cannot be fully disabled.
boolean
Example
[ { "type": "weekly_summary.submitted", "channels": [ "in_app" ] }]Missing/invalid credentials.
Media type application/json
object
code
required
string
message
required
string
Example generated
{ "code": "example", "message": "example"}