Explorar la referencia
Todos los recursos
Notificaciones
6 endpoints · Las descripciones de los endpoints están en inglés.
List the current user's notifications, newest first. Defaults: undismissed + unread only.
GET
/notificationsread:notifications
Parámetros
| Nombre | En | Obligatorio |
|---|---|---|
| includeRead | query | Opcional |
| includeDismissed | query | Opcional |
| limit | query | Opcional |
| cursor | query | Opcional |
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X GET https://api.vokse.ai/notificationsRespuesta200 · Success
Dismiss a notification (hides from the active feed)
DELETE
/notifications/{id}write:notifications
Parámetros
| Nombre | En | Obligatorio |
|---|---|---|
| id | path | Obligatorio |
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X DELETE https://api.vokse.ai/notifications/{id}Respuesta204 · No content
Mark a single notification read (idempotent)
POST
/notifications/{id}/readwrite:notifications
Parámetros
| Nombre | En | Obligatorio |
|---|---|---|
| id | path | Obligatorio |
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X POST https://api.vokse.ai/notifications/{id}/readRespuesta200 · Success
Mark every unread notification as read for the current user
POST
/notifications/mark-all-readwrite:notifications
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X POST https://api.vokse.ai/notifications/mark-all-readRespuesta200 · Success
List the current user's notification preferences. Auto-seeds defaults on first call.
GET
/notifications/preferencesread:notifications
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -X GET https://api.vokse.ai/notifications/preferencesRespuesta200 · Success
Upsert (kind, channel, enabled, lockScreenDetails) preferences for the current user. lockScreenDetails is accepted on the push channel only.
PUT
/notifications/preferenceswrite:notifications
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \ -H "Idempotency-Key: $(uuidgen)" \ -X PUT https://api.vokse.ai/notifications/preferencesRespuesta200 · Success