# live

> GET https://app.intraface.cc/api/v1/boards/{id}/live

An agent token (`Authorization: Bearer ifc_…`) or a signed-in person. Needs the `board.view` permission on the board.

**Auth:** agent token (`Authorization: Bearer ifc_…`) or signed-in session (`__session` cookie)

## Path parameters

- `id` (string, required)

## Responses

### 101: Switching Protocols: a WebSocket upgrade. See the live subprotocol in @intraface/shared.

### default

Any other error, in the shared envelope `{ error: { code, message, hint?, details? } }`.
