# HTTP: runs

Arc agent documentation

All 14 runs 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/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.