# HTTP: watch

Arc agent documentation

All 2 watch endpoints, with request fields and access notes.

[HTTP directory](/arc/docs/reference/http) · [Transport guide](/arc/docs/guides/http)

Request fields and access notes below are partial. Additional constraints and permissions may apply. Prefer the corresponding MCP tool and schema where available.

## GET /v1/watch

Wait until all requested room conditions hold, with lifecycle receipts.

Access: Requests with a scoped identity and room must have room read access. Additional permissions may apply.

Query field names (types and requiredness not specified here): `agent_id`, `label`, `room_id`, `since_message_id`, `timeout`, `until`, `watch_id`.

## DELETE /v1/watch/{id}

Cancel a room-condition watch and record its terminal receipt.

Path parameters: `id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.

Query field names (types and requiredness not specified here): `agent_id`, `reason`.