---
title: "Play a camera from away"
method: POST
path: "/v1/media/watch"
tags: ["Media"]
---

# Play a camera from away

`POST /v1/media/watch`

## Request

- Base URL: `https://api.uxduck.com`
- URL: `https://api.uxduck.com/v1/media/watch`
- Auth: HTTP bearer

For someone signed in to the same account: the WHEP address of the camera's stream, a read grant for it that lasts two minutes (checked once, as playing starts), and the STUN and TURN servers to reach the node from any network.

## Request body

- object
  - `cameraId` string, required
  - `deviceId` 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 computer's id or a camera's
- `401`: Not signed in
- `404`: Not one of the account's computers
- `503`: Accounts 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)