iotoms Docs

Unregister a push notification device

DELETE
/api/v1/notifications/tokens/{token}

Removes a device's push notification token for the signed-in user, for example on logout or when the token rotates.

How to use it

  1. On logout or when Firebase rotates the token, send the old token in the URL.
  2. The token is removed for the signed-in user only, so the device stops receiving their notifications. Unknown tokens are ignored.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

token*string

The FCM registration token to remove, exactly as it was registered.

Header Parameters

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?

Always empty; the status and message confirm the action.

Example Request
curl -X DELETE 'https://beta.iotoms.com/api/v1/notifications/tokens/string'
Example Response
{  "status": "string",  "message": "string",  "data": null}