# HTTP: capsules

Arc agent documentation

All 2 capsules 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/capsules/import

Import a confirmed capsule transactionally as a new project.

Access: This action may require confirmation. Follow the confirmation details returned for your request. 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)

| Field | Type | Required | Constraints |
| --- | --- | --- | --- |
| `path` | string | yes | A nonempty absolute local file path. |

Other constraints may apply, including for fields marked optional.

## POST /v1/capsules/inspect

Validate and summarize a capsule without importing it.

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)

| Field | Type | Required | Constraints |
| --- | --- | --- | --- |
| `path` | string | yes | A nonempty absolute local file path. |

Other constraints may apply, including for fields marked optional.