Notifly
API ReferenceSubscribers

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

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.

Authorization

secretKey
Authorization<token>

API key authentication. Allowed headers-- "Authorization: ApiKey <secret_key>".

In: header

Path Parameters

subscriberId*string
providerId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/subscribers/string/credentials/string/token" \  -H "Content-Type: application/json" \  -d '{    "token": "string"  }'
{  "data": {    "_id": "string",    "firstName": "string",    "lastName": "string",    "email": "string",    "phone": "string",    "avatar": "string",    "locale": "string",    "channels": [      {        "providerId": "slack",        "integrationIdentifier": "string",        "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"        },        "_integrationId": "string"      }    ],    "topics": [      "string"    ],    "isOnline": true,    "lastOnlineAt": "string",    "__v": 0,    "data": {},    "timezone": "string",    "subscriberId": "string",    "_organizationId": "string",    "_environmentId": "string",    "deleted": true,    "createdAt": "string",    "updatedAt": "string"  }}

Register a device token POST

Idempotently register ONE **deviceToken** on the subscriber's **providerId** channel (e.g. **fcm**, **apns**). Re-registering the same token is a no-op (no duplicate). Pass **previousToken** to atomically swap a rotated token. On overflow the OLDEST tokens are dropped. Never wipes the channel — unlike a whole-array credentials update. The token travels in the body because it may contain URL-hostile characters.

Update subscriber online status PATCH

Update the subscriber online status by its unique key identifier **subscriberId**