---
title: "Play a camera with a watch link"
method: POST
path: "/v1/watch/{token}/video"
tags: ["Watch links"]
---

# Play a camera with a watch link

`POST /v1/watch/{token}/video`

## Request

- Base URL: `https://api.uxduck.com`
- URL: `https://api.uxduck.com/v1/watch/{token}/video`
- Auth: none declared

As `/v1/media/watch` for the account (S84, W5): a two-minute WHEP read grant and the ICE servers, for a camera of the link's vehicle, or of any vehicle on the computer for a link that shows them all.

## Path parameters

- `token` string, required

## Request body

- object
  - `cameraId` string, required
  - `nodeId` string, nullable

## Response `200`

Where and how to play it

- object
  - `expiresAtMs` integer, required
  - `grant` string, required
  - `iceServers` object[], required
    - `credential` string, nullable
    - `urls` string[], required
    - `username` string, nullable
  - `streamId` string, required
  - `whepUrl` string, required

## Other responses

- `400`: Not a camera's id
- `404`: Not a camera this link shows
- `410`: The link has ended
- `503`: Accounts, the relay or live video are not set up here

---

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