Saltar al contenido
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/notifications
read:notifications

Parámetros

NombreEnObligatorio
includeReadqueryOpcional
includeDismissedqueryOpcional
limitqueryOpcional
cursorqueryOpcional
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/notifications
Respuesta200 · Success

Dismiss a notification (hides from the active feed)

DELETE/notifications/{id}
write:notifications

Parámetros

NombreEnObligatorio
idpathObligatorio
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}/read
write:notifications

Parámetros

NombreEnObligatorio
idpathObligatorio
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/notifications/{id}/read
Respuesta200 · Success

Mark every unread notification as read for the current user

POST/notifications/mark-all-read
write: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-read
Respuesta200 · Success

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

GET/notifications/preferences
read:notifications
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/notifications/preferences
Respuesta200 · Success

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

PUT/notifications/preferences
write:notifications
Ejemplo de petición
bash
curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X PUT https://api.vokse.ai/notifications/preferences
Respuesta200 · Success