Vai al contenuto
vokse.
Sfoglia il riferimento
Tutte le risorse

Notifiche

6 endpoint · Le descrizioni degli endpoint sono in inglese.

List the current user's notifications, newest first. Defaults: undismissed + unread only.

GET/notifications
read:notifications

Parametri

NomePosizioneObbligatorio
includeReadqueryFacoltativo
includeDismissedqueryFacoltativo
limitqueryFacoltativo
cursorqueryFacoltativo
Richiesta di esempio
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/notifications
Risposta200 · Success

Dismiss a notification (hides from the active feed)

DELETE/notifications/{id}
write:notifications

Parametri

NomePosizioneObbligatorio
idpathObbligatorio
Richiesta di esempio
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X DELETE https://api.vokse.ai/notifications/{id}
Risposta204 · No content

Mark a single notification read (idempotent)

POST/notifications/{id}/read
write:notifications

Parametri

NomePosizioneObbligatorio
idpathObbligatorio
Richiesta di esempio
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/notifications/{id}/read
Risposta200 · Success

Mark every unread notification as read for the current user

POST/notifications/mark-all-read
write:notifications
Richiesta di esempio
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/notifications/mark-all-read
Risposta200 · Success

List the current user's notification preferences. Auto-seeds defaults on first call.

GET/notifications/preferences
read:notifications
Richiesta di esempio
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/notifications/preferences
Risposta200 · Success

Upsert (kind, channel, enabled, lockScreenDetails) preferences for the current user. lockScreenDetails is accepted on the push channel only.

PUT/notifications/preferences
write:notifications
Richiesta di esempio
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X PUT https://api.vokse.ai/notifications/preferences
Risposta200 · Success