Core
API v2.x
2

unsubscribe #

Removes a subscription.


Query Syntax #

HTTP #

Due to the synchronous nature of the HTTP protocol, real-time messaging is not supported

Other protocols #

{
  "controller": "realtime",
  "action": "unsubscribe",
  "body": {
    "roomId": "<unique room ID>"
  }
}

Body properties #

  • roomId: subscription identifier to room

Response #

Returns the removed subscription identifier.

{
  "status": 200,
  "error": null,
  "index": "<index>",
  "collection": "<collection>",
  "controller": "realtime",
  "action": "unsubscribe",
  "volatile": {}, // subscription volatile data
  "requestId": "<unique request identifier>",
  "result": {
    "roomId": "<unique Kuzzle room identifier>"
  }
}