Skip to navigation
NotificationsNotification APIpush-notifications

Unsubscribe device tokens from topic

Unsubscribe one or more device tokens from a Firebase topic.

Features:

  • Bulk unsubscription of multiple tokens
  • Success/failure count for each operation
  • Idempotent operation (safe to retry)
  • Graceful handling of non-existent subscriptions

Use Cases:

  • User preference changes
  • App uninstallation cleanup
  • Topic management and maintenance
  • Privacy compliance (opt-out)

Behavior:

  • Unsubscribing from non-existent topics succeeds
  • Invalid tokens are reported in failure count
  • Partial failures still process valid tokens

Authentication

AuthorizationBearer

JWT token for authentication. Use ‘test-jwt-token’ for development.

Request

This endpoint expects an object.
tokenslist of stringsRequired
topicstringRequired

Response

This endpoint returns an object.
successboolean
dataobjectOptional
errorobjectOptional