---
title: "Watch with a watch link"
method: GET
path: "/v1/watch/{token}/live"
tags: ["Watch links"]
---

# Watch with a watch link

`GET /v1/watch/{token}/live`

## Request

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

A WebSocket for a guest: `edge/presence`, `edge/snapshot` and `edge/delta` as a signed-in viewer gets them, for the link's vehicle only if it names one. `edge/watch` and `edge/watchVideo` work; commands, the lease and receipts answer `watch-only`. Closed with 4002 when the link ends and 4003 when it already has 100 guests.

## Path parameters

- `token` string, required

## Other responses

- `101`: Switching to the WebSocket
- `410`: The link has ended
- `426`: Not a WebSocket upgrade
- `503`: Accounts or the relay 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)