Push notifications

API reference descriptions are provided in English to preserve the exact published contract.

GETList the signed-in user's registered browsers in this account and environmentpush.subscriptions.list
POSTRegister this browser for push notificationspush.subscriptions.create
DELETEWithdraw this browser's push subscriptionpush.subscriptions.delete
GETThe public key a browser subscribes withpush.vapid.list

List the signed-in user's registered browsers in this account and environment

GET/v1/accounts/{AC}/push/subscriptions

push.subscriptions.listSDK operation getV1AccountsByAcPushSubscriptions

Required scope: notifications:read.Paginated

Parameters

limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/push/subscriptions

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/push/subscriptions" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Register this browser for push notifications

POST/v1/accounts/{AC}/push/subscriptions

push.subscriptions.createSDK operation postV1AccountsByAcPushSubscriptions

Required scope: notifications:read.Idempotency-Key required

Request body

endpointstring (max 2048 chars)Required
keysobjectRequired
Show 2 child attributes
- authstring (max 64 chars)Required
- p256dhstring (max 200 chars)Required
userAgentstring (max 512 chars)

POST /v1/accounts/{AC}/push/subscriptions

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/push/subscriptions" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "endpoint": "string",
  "keys": {
    "auth": "string",
    "p256dh": "string"
  }
}'

Responses

Withdraw this browser's push subscription

DELETE/v1/accounts/{AC}/push/subscriptions

push.subscriptions.deleteSDK operation deleteV1AccountsByAcPushSubscriptions

Required scope: notifications:read.

Request body

endpointstring (max 2048 chars)Required

DELETE /v1/accounts/{AC}/push/subscriptions

curl -X DELETE "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/push/subscriptions" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Content-Type: application/json" \
  -d '{
  "endpoint": "string"
}'

Responses

The public key a browser subscribes with

GET/v1/accounts/{AC}/push/vapid

push.vapid.listSDK operation getV1AccountsByAcPushVapid

Required scope: notifications:read.

GET /v1/accounts/{AC}/push/vapid

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/push/vapid" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses