HTTP endpoints
HTTP: runs
All 14 runs endpoints, with request fields and access notes.
On this page
- GET /v1/runs
- POST /v1/runs
- GET /v1/runs/{id}
- POST /v1/runs/{id}/complete
- POST /v1/runs/{id}/report
- GET /v1/runs/{id}/seat-context
- POST /v1/runs/{id}/seat-context-exclude
- POST /v1/runs/{id}/seat-reply-edit
- POST /v1/runs/{id}/seat-retry
- POST /v1/runs/{id}/seat-rewind
- GET /v1/runs/{id}/seat-status
- POST /v1/runs/{id}/seat-stops
- POST /v1/runs/{id}/seat-turns
- POST /v1/runs/{id}/stop
HTTP directory · Transport guide
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/runs
List commissioned runs or commission an objective across managed seats.
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): room_id, status.
POST /v1/runs
List commissioned runs or commission an objective across managed seats.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
GET /v1/runs/{id}
Read commissioned run.
Path parameters: id.
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): detail, max_chars.
POST /v1/runs/{id}/complete
Commissioned run complete.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
Additional body field names (types and requiredness not specified here): detail, max_chars.
POST /v1/runs/{id}/report
Commissioned run report.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
Additional body field names (types and requiredness not specified here): detail.
GET /v1/runs/{id}/seat-context
Read commissioned run seat context.
Path parameters: id.
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, max_chars, membership_id.
POST /v1/runs/{id}/seat-context-exclude
Commissioned run seat context exclude.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/runs/{id}/seat-reply-edit
Commissioned run seat reply edit.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/runs/{id}/seat-retry
Commissioned run seat retry.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/runs/{id}/seat-rewind
Commissioned run seat rewind.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
GET /v1/runs/{id}/seat-status
Read commissioned run seat status.
Path parameters: id.
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, membership_id.
POST /v1/runs/{id}/seat-stops
Commissioned run seat stop.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/runs/{id}/seat-turns
Commissioned run seat turn.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.
POST /v1/runs/{id}/stop
Commissioned run stop.
Path parameters: id.
Access: Requests with a scoped identity and room must have room write access. Additional permissions may apply. LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply.
This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.