Skip to content
TokenBotTokenBotTokenBot

Notifications

Manage user notifications.

Endpoints

Section titled “Endpoints”
MethodPathDescription
DELETE/v1/notifications/:idDelete notification

Delete Notification

Section titled “Delete Notification”
DELETE /v1/notifications/:id
Terminal window
curl -X DELETE https://api.tokenbot.com/v1/notifications/notif_abc123 \
  -H "X-API-Key: tb_live_your_key"

Returns 204 No Content.

Removed endpoints

Section titled “Removed endpoints”

GET /v1/notifications, GET /v1/notifications/count, POST /v1/notifications/:id/read and POST /v1/notifications/read-all were removed in 2026-07. They were documented but never functional: each one proxied to a GraphQL field (get_notifications, notification_count, mark_notification_read, mark_all_notifications_read) that has never existed in the platform schema, so every call failed at validation time. They are not deprecated in favour of anything — there is currently no way to list, count or mark notifications read over the API.