# HTTP: local-agent

Arc agent documentation

All 31 local-agent 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.

## POST /v1/local-agent/credentials/status

Local agent credential status.

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.

## DELETE /v1/local-agent/credentials/{target}

Local agent delete credential.

Path parameters: `target`.

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/local-agent/credentials/{target}

Local agent store credential.

Path parameters: `target`.

Access: 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): `value`.

## POST /v1/local-agent/ingress-authorizations

Manage desktop ingress authorizations using desktop-specific credentials.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply. Reserved for the Arc desktop integration; requires its client and authorization headers. Ordinary agent sessions cannot use this endpoint.

Additional body field names (types and requiredness not specified here): `action`.

## POST /v1/local-agent/messages/{message_id}/workspace-file

Local agent message file.

Path parameters: `message_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/local-agent/models

Local agent models.

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/local-agent/peer-note

Local agent peer note.

Access: 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): `note`, `to_agent`.

## POST /v1/local-agent/probe

Local agent probe.

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/local-agent/providers

Read local agent providers.

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

## GET /v1/local-agent/sessions

Read local agent sessions.

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

## POST /v1/local-agent/sessions

Local agent start.

Access: 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): `generation_id`.

## GET /v1/local-agent/sessions/resumable

Read local agent resumable.

Query field names (types and requiredness not specified here): `room_id`.

## DELETE /v1/local-agent/sessions/{id}

Local agent stop.

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. Managed-seat operations require authority for the targeted seat.

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

## GET /v1/local-agent/sessions/{id}

Read local agent session.

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/local-agent/sessions/{id}/approvals/{approval_id}

Local agent approval.

Path parameters: `id`, `approval_id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/cancel

Local agent 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. Managed-seat operations require authority for the targeted seat.

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

## GET /v1/local-agent/sessions/{id}/context

Read local agent context.

Path parameters: `id`.

Query field names (types and requiredness not specified here): `max_chars`.

## GET /v1/local-agent/sessions/{id}/history

Read local agent history.

Path parameters: `id`.

Query field names (types and requiredness not specified here): `limit`.

## GET /v1/local-agent/sessions/{id}/history/{change_id}

Read local agent history preview.

Path parameters: `id`, `change_id`.

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

## POST /v1/local-agent/sessions/{id}/history/{turn_id}/exclude

Local agent history exclude.

Path parameters: `id`, `turn_id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/history/{turn_id}/reply

Local agent history reply.

Path parameters: `id`, `turn_id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply. Managed-seat operations require authority for the targeted seat.

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

## GET /v1/local-agent/sessions/{id}/journal

Read local agent journal.

Path parameters: `id`.

Query field names (types and requiredness not specified here): `kinds`, `limit`, `turn_id`.

## POST /v1/local-agent/sessions/{id}/note

Local agent note.

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. Managed-seat operations require authority for the targeted seat.

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

## DELETE /v1/local-agent/sessions/{id}/queued-turns/{queue_id}

Local agent queued turn.

Path parameters: `id`, `queue_id`.

Access: LAN writes require an active session token. Local loopback requests are exempt from this requirement by default; other permissions still apply. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/retry

Local agent retry.

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. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/rewind

Local agent rewind.

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. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/shell-artifacts

Local agent shell artifact.

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. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/turns

Local agent turn.

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. Managed-seat operations require authority for the targeted seat.

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

## POST /v1/local-agent/sessions/{id}/undo

Local agent undo.

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. Managed-seat operations require authority for the targeted seat.

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

## GET /v1/local-agent/settings

Read local agent settings.

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

## PATCH /v1/local-agent/settings

Local agent update 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.