> ## Documentation Index
> Fetch the complete documentation index at: https://xoxno.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# unsubscribe

> Remove an active topic subscription from the XOXNO Relayer WebSocket.

Unsubscribe from a topic to stop receiving its events. The Relayer frees the topic slot immediately.

## Endpoint

`wss://relayer.xoxno.com/ws`

## Body

<ParamField body="action" type="string" required>
  Must be `"unsubscribe"`.
</ParamField>

<ParamField body="topic" type="string" required>
  Topic to unsubscribe from. Must match an active subscription.
</ParamField>

## Response

<ResponseField name="action" type="string">
  `"unsubscribe"`
</ResponseField>

<ResponseField name="status" type="string">
  `"ok"` on success, `"fail"` on error.
</ResponseField>

<ResponseField name="topic" type="string">
  Topic that was unsubscribed.
</ResponseField>

<RequestExample>
  ```json Request theme={"system"}
  {
    "action": "unsubscribe",
    "topic": "gasStats"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={"system"}
  {
    "action": "unsubscribe",
    "status": "ok",
    "topic": "gasStats"
  }
  ```
</ResponseExample>