Reference · 12.05

HTTP API Reference

The full /v1 surface grouped by area — auth, agents, workflows, runs, Brain, apps, reach, and governance.

HTTPREST

Auth & workspace

Every request authenticates with Authorization: Bearer $AGENTIS_API_KEY. Auth issues RS256 JWTs; keys are hashed at rest — see Auth & Secrets.

Area	Endpoints
Auth	`/v1/auth`, `/v1/oauth`, `/v1/jwks`, `/.well-known`
Workspace	`/v1/workspaces`, `/v1/domains`, `/v1/ambients`, `/v1/workspace-context`, `/v1/workspace-intelligence`, `/v1/sovereignty`, `/v1/workspace/bundle`
Credentials	`/v1/credentials`

Area	Endpoints
Agents	`/v1/agents`, `/v1/specialists`, `/v1/harness`, `/v1/harness-import`, `/v1/conversations`, `/v1/interactions`, `/v1/terminal`
Workflows	`/v1/workflows`, `/v1/workflow-io`, `/v1/triggers`, `/v1/listeners`, `/v1/scheduler`, `/v1/ephemeral`
Runs	`/v1/runs`, `/v1/replay`, `/v1/history`, `/v1/rooms`, `/v1/tasks`
Issues	`/v1/issues`

Area	Endpoints
Brain	`/v1/brain`, `/v1/memory`, `/v1/personal-brain`, `/v1/knowledge-bases`, `/v1/skills`, `/v1/grounding`
Apps	`/v1/apps`, `/v1/packages`, `/v1/artifacts`, `/v1/capabilities`, `/v1/tools`
Reach	`/v1/channels`, `/v1/gateways`, `/v1/mcp`, `/v1/mcp-servers`, `/v1/mcp-oauth`, `/v1/integrations`, `/v1/a2a`, `/v1/webhooks`, `/v1/extensions`, `/v1/extension-registry`

Area	Endpoints
Governance	`/v1/budgets`, `/v1/approvals`, `/v1/audit`, `/v1/observability`, `/v1/governance`, `/v1/analytics`, `/v1/command`, `/v1/command-autonomy`
Platform	`/v1/dashboard`, `/v1/activity`, `/v1/orchestrator-models`, `/v1/issues`, `/v1/test-harness`

The API is self-describing: a running instance serves its own OpenAPI document and a Scalar reference UI.

channel.send/list, capability.search/load/invoke, mcp.list/call, extension.create/test, media.generate, and experiment.define/record.

agentis bootstrap, up, backup/restore, pnpm doctor, pnpm dev, and pnpm lint — every command and what it does.