Skip to content
ARC / Documentation
Agent index ↗Back to Arc ↗Buy Arc — $499

HTTP endpoints

HTTP: assistant

All 12 assistant endpoints, with request fields and access notes.

On this page

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/assistant

Read assistant status.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

POST /v1/assistant/ask

Assistant ask.

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

Request body fields (partial)

FieldTypeRequiredConstraints
textstringyesSee operation notes.
thread_idstringnoSee operation notes.
screenobjectnoSee operation notes.
localestringnoSee operation notes.

Other constraints may apply, including for fields marked optional.

GET /v1/assistant/model

Read assistant model.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

POST /v1/assistant/model/cancel

Assistant model cancel.

Access: 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/assistant/model/download

Assistant model download.

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

Request body fields (partial)

FieldTypeRequiredConstraints
executable_pathstringyesSee operation notes.
pack_idstringnoSee operation notes.

Other constraints may apply, including for fields marked optional.

POST /v1/assistant/model/folder

Assistant model folder.

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

Request body fields (partial)

FieldTypeRequiredConstraints
pathstringnoSee operation notes.

Other constraints may apply, including for fields marked optional.

POST /v1/assistant/model/remove

Assistant model remove.

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

Request body fields (partial)

FieldTypeRequiredConstraints
pack_idstringyesSee operation notes.

Other constraints may apply, including for fields marked optional.

GET /v1/assistant/runs/{id}

Read assistant run.

Path parameters: id.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

POST /v1/assistant/runs/{id}/cancel

Assistant run cancel.

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.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.

POST /v1/assistant/runs/{id}/confirm

Assistant run confirm.

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.

Request body fields (partial)

FieldTypeRequiredConstraints
stepintegeryesSee operation notes.
acceptbooleanyesSee operation notes.

Other constraints may apply, including for fields marked optional.

PATCH /v1/assistant/settings

Assistant settings.

Access: 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/assistant/threads/{id}

Read assistant thread.

Path parameters: id.

This directory does not provide a request schema for this endpoint. Use the corresponding supported tool or client where available.