Unregister push device for user

DELETE

/domains/{domain}/users/{user}/push

Last modified:2026-10-30 21:24:15

OperationId:UnregisterPushConfigurationUser

Unregisters one of a user's devices from push notifications, removing one token or switching off the device's push delivery. A mobile or web app calls it when the user logs out. Requires Reseller or Super User scope to unregister another user's device; every other scope except the read-only ones unregisters only its own.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after. The body names the device.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

Remove one tokenRemove web app registrations

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//push' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "push-device": "sip:1001a@example.com",
    "push-device-token": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
    "push-network": "apns"
}'

Response Example

202 - Unregistered

Accepted; applied shortly after.

{
    "response": "ok",
    "device": "sip:1001a@example.com"
}

Modified at 2026-10-30 21:24:15

Update push registration for user