# HTTP: agent-profiles

Arc agent documentation

All 5 agent-profiles 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/agent-profiles

Read agent profiles.

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

## POST /v1/agent-profiles

Create agent profile.

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/agent-profiles/{id}

Disable agent profile.

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.

## PATCH /v1/agent-profiles/{id}

Patch agent profile.

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/agent-profiles/{id}/runtime-binding

Replace agent runtime.

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.