---
title: "Issue a one-time token to open the live WebSocket"
method: POST
path: "/v2/live/token"
tags: ["Live Api Service"]
---

# Issue a one-time token to open the live WebSocket

`POST /v2/live/token`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/live/token`
- Auth: none declared

## Response `200`

Token issued

- JsonOkResponseLiveTokenDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` LiveTokenDto: One-time token to open the live WebSocket, sent in the handshake as the metricool.live.token.<ott> subprotocol
    - `ott` string: One-time token; valid once and only for a few seconds
    - `expiresIn` integer: Seconds the token stays valid

## Other responses

- `403`: The request is not an interactive user session
- `404`: The live channel is not enabled
- `429`: Too many tokens requested

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)