Subscribers

Remove a device token

Remove exactly ONE deviceToken from the subscriber's providerId channel. Removing an absent token is a no-op. This NEVER clears the whole channel and leaves every other token intact. The token travels in the body because it may contain URL-hostile characters.

delete/v1/subscribers/{subscriberId}/credentials/{providerId}/token

Request

  • Base URL: https://api.notifly.io
  • URL: https://api.notifly.io/v1/subscribers/{subscriberId}/credentials/{providerId}/token
  • Auth: API key in header Authorization

Path parameters

subscriberIdstring required
providerIdstring required

Request body

tokenstring required

The device/push token to remove. Sent in the body (not the path) because tokens can contain URL-hostile characters (e.g. a JSON-stringified web-push subscription). Only this token is removed; the rest of the channel is left intact.

integrationIdentifierstring

Disambiguate when the environment has multiple active integrations for this provider.

Response

OK

Example response

{
  "data": {
    "channels": [
      {
        "credentials": {
          "webhookUrl": "https://example.com/webhook",
          "channel": "general",
          "deviceTokens": [
            "token1",
            "token2",
            "token3"
          ],
          "alertUid": "12345-abcde",
          "title": "Critical Alert",
          "imageUrl": "https://example.com/image.png",
          "state": "resolved",
          "externalUrl": "https://example.com/details"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.