---
title: "Create viewer token"
method: POST
path: "/streams/{stream_id}/viewer-token"
tags: ["Streams"]
---

# Create viewer token

`POST /streams/{stream_id}/viewer-token`

Issues a short-lived, subscribe-only LiveKit token so the stream owner can watch
the video the model is ingesting. The token cannot publish media or data-channel
messages. Connect with any LiveKit client SDK and render the remote video track.

## Response `200`

Viewer token issued.

- ViewerTokenResponse
  - `id` string, uuid, required — The stream identifier the token was issued for.
  - `view` ViewInfo, required — WebRTC view target. Connect with the LiveKit client SDK and subscribe to the remote video track.
    - `type` 'livekit', required
    - `url` string, required — LiveKit room URL (`wss://...`).
    - `token` string, required — Short-lived subscribe-only JWT. Cannot publish media or data-channel messages.
    - `expires_in_seconds` integer, required — Seconds until the token expires. Request a new one when it does.

## Other responses

- `401` — Missing or invalid API key.
- `404` — Stream unknown, expired, deleted, or owned by a different user.
- `409` — Wrong region.

---

[API](https://skmtc.net/overshoot/apis/overshoot-api.md) · [All operations](https://skmtc.net/overshoot/apis/overshoot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/overshoot/overshoot-api/versions/defe49d6c837/schema)