Unregister push device

DELETE

/push

Last modified:2026-10-03 07:43:29

OperationId:UnregisterPushConfigurationSystem

Unregisters a device from push notifications anywhere on the platform. A mobile or web app calls it when the user logs out.

Who can call it:

Every scope except the read-only ones can unregister a device it owns. Below Reseller, the body must name you: add "user": "~", or your own domain and user. Without them the request gets 403.

Reseller unregisters any device in a domain of its territory.

Super User unregisters any device.

Super User Read Only and Office Manager Read-Only get 403.

What happens:

push-device is required and must be an existing device within your reach. Any other answers 404 with Device not found. Below Reseller it must be your own device.

With push-device-token, that registration is removed. The token must be registered on that device, or the request returns 404. A token that is not registered at all is treated as already removed.

Without push-device-token, the registrations stay and only the device's push delivery is switched off.

Push delivery is switched off for the device, except for an apns_chat token, which covers chat only and leaves call notifications on.

With push-network pwa, every web push registration of the user named by domain and user is removed instead, and push-device is not needed. Send both, or "user": "~" for your own; without them the request returns 400. The answer is {"response": "ok"} with no device.

Answers 202 with {"response": "ok", "device": ...}. The change is accepted and applied shortly after, so a read made straight after it can still show the previous state.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Accepted; 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 token (own device)Remove web app registrations (own device)

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/push' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user": "~",
    "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-03 07:43:29

Update push registration