Skip to main content
POST
/
v1
/
public
/
topics.unsubscribe
curl --location --request POST 'https://api.yourapp.com/v1/public/topics.unsubscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "topic-uuid-123"
}'

{
  "data": {
    "ok": true
  }
}

​
Authentication

Authorization: Bearer SUBSCRIBER_JWT_TOKEN

​
Request Body

​
id
string
required
Topic ID (UUID) to unsubscribe from

​
Response

​
data
object
Unsubscription result
curl --location --request POST 'https://api.yourapp.com/v1/public/topics.unsubscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "topic-uuid-123"
}'

{
  "data": {
    "ok": true
  }
}

​
Behavior

  • Event Trigger: Fires topic-subscribers.delete event
  • Idempotent: Safe to call even if not subscribed

​
Notes

  • Stops all notifications for this topic
  • Returns success even if subscription didn’t exist