In der Referenz stöbern
Alle Ressourcen
Benachrichtigungen
6 Endpunkte · Die Endpunktbeschreibungen sind auf Englisch.
List the current user's notifications, newest first. Defaults: undismissed + unread only.
GET
/notificationsread:notifications
Parameter
| Name | Ort | Erforderlich |
|---|---|---|
| includeRead | query | Optional |
| includeDismissed | query | Optional |
| limit | query | Optional |
| cursor | query | Optional |
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X GET https://api.vokse.ai/notificationsAntwort200 · Success
Dismiss a notification (hides from the active feed)
DELETE
/notifications/{id}write:notifications
Parameter
| Name | Ort | Erforderlich |
|---|---|---|
| id | path | Erforderlich |
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X DELETE https://api.vokse.ai/notifications/{id}Antwort204 · No content
Mark a single notification read (idempotent)
POST
/notifications/{id}/readwrite:notifications
Parameter
| Name | Ort | Erforderlich |
|---|---|---|
| id | path | Erforderlich |
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X POST https://api.vokse.ai/notifications/{id}/readAntwort200 · Success
Mark every unread notification as read for the current user
POST
/notifications/mark-all-readwrite:notifications
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X POST https://api.vokse.ai/notifications/mark-all-readAntwort200 · Success
List the current user's notification preferences. Auto-seeds defaults on first call.
GET
/notifications/preferencesread:notifications
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X GET https://api.vokse.ai/notifications/preferencesAntwort200 · Success
Upsert (kind, channel, enabled, lockScreenDetails) preferences for the current user. lockScreenDetails is accepted on the push channel only.
PUT
/notifications/preferenceswrite:notifications
Beispielanfrage
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X PUT https://api.vokse.ai/notifications/preferencesAntwort200 · Success