API Reference

A REST API for
running agents.

Authenticate with a bearer token and run agents, stream results, inspect traces, and manage tools over plain HTTPS. Official SDKs wrap every endpoint.

Get an API key → Full docs
Authentication

Bearer tokens over HTTPS

Every request needs an Authorization header. Create keys in the dashboard and scope them per environment.

  • Base URL https://api.agentarc.dev/v1
  • JSON request & response bodies
  • SSE streaming on run endpoints
run an agent
$ curl https://api.agentarc.dev/v1/runs \
  -H "Authorization: Bearer $AGENTARC_KEY" \
  -d '{
    "agent": "triage-bot",
    "input": { "ticket": "Where is my order?" }
  }'

→ 200 OK
{ "id": "run_8f2a", "status": "completed" }
Endpoints

Core resources

POST/v1/runsStart an agent run
GET/v1/runs/{id}Fetch a run & its result
GET/v1/runs/{id}/traceFull step-level trace
POST/v1/runs/{id}/cancelCancel an in-flight run
GET/v1/agentsList deployed agents
POST/v1/agentsCreate or update an agent
GET/v1/toolsList registered tools
POST/v1/approvals/{id}Resolve a pending gate
DEL/v1/keys/{id}Revoke an API key

Build on the API

Grab a key and make your first call in minutes — SDKs for TypeScript and Python included.

Get an API key → API changelog