Agents

All paths are relative to https://<subdomain>.exohuman.cc. See Overview & authentication for tokens.

List and inspect

Endpoint	Method	Description
/api/agents	GET	Agents you can see — admins every agent, others their owned and shared agents
/api/agents/{name}	GET	Agent details and status
/api/agents/{name}/info	GET	Template metadata
/api/agents/{name}/stats	GET	Live CPU, memory and context telemetry
/api/agents/{name}/analytics	GET	Execution analytics (?window=7d|14d|30d)
/api/agents/{name}/logs	GET	Container logs

curl -s https://acme.exohuman.cc/api/agents \
  -H "Authorization: Bearer $EXOHUMAN_API_KEY" | jq '.[].name'

Create, rename, delete

Endpoint	Method	Description
/api/agents	POST	Create an agent
/api/agents/{name}/rename	PUT	Rename the agent’s id (restarts it)
/api/agents/{name}/label	GET / PUT	Display name; null resets to the id
/api/agents/{name}	DELETE	Delete the agent

curl -X POST https://acme.exohuman.cc/api/agents \
  -H "Authorization: Bearer $EXOHUMAN_API_KEY" -H 'Content-Type: application/json' \
  -d '{"name":"research-analyst","display_label":"Research Analyst","template":"github:acme/research-analyst","runtime":"claude-code"}'

runtime is one of the runtime ids (claude-code, codex, gemini-cli, opencode, pi); omitted, the instance default is used.

Creating agents requires the creator or admin role and counts against your agent quota. See Creating agents for templates.

Lifecycle

Endpoint	Method	Description
/api/agents/{name}/start	POST	Start the agent
/api/agents/{name}/stop	POST	Stop the agent

On ExoHuman Cloud, a running agent is billed per minute on its compute profile.

Configuration

Endpoint	Method	Description
/api/agents/{name}/autonomy	GET / PUT	Autonomy — whether schedules run
/api/agents/{name}/read-only	GET / PUT	Read-only mode
/api/agents/{name}/timeout	GET / PUT	Per-task execution timeout
/api/agents/{name}/resources	GET / PUT	Memory and CPU limits (applied on next restart)
/api/agents/{name}/model	GET / PUT	Model for subsequent messages
/api/agents/{name}/circuit-breaker	GET / PUT	Circuit-breaker state and enablement
/api/agents/{name}/mcp-exposed	GET / PUT	Publish as a dedicated MCP tool

Files

Endpoint	Method	Description
/api/agents/{name}/files	GET / PUT / DELETE	File tree, save a text file, delete
/api/agents/{name}/files/download	GET	Download a file
/api/agents/{name}/files/preview	GET	Preview a file
/api/agents/{name}/files/mkdir	POST	Create a folder
/api/agents/{name}/folders	GET / PUT	Shared folders

Credentials

Endpoint	Method	Description
/api/agents/{name}/credentials/status	GET	Which credential files are present
/api/agents/{name}/credentials/inject	POST	Write credential files into the agent
/api/agents/{name}/credentials/export	POST	Export encrypted credentials
/api/agents/{name}/credentials/import	POST	Import encrypted credentials
/api/agents/{name}/credential-requirements	GET	Per-variable setup checklist

Only owners and admins manage credentials. See Credential management.

Sharing

Endpoint	Method	Description
/api/agents/{name}/share	POST	Share with an email ({"email": "…"})
/api/agents/{name}/share/{email}	DELETE	Remove a share
/api/agents/{name}/shares	GET	List shares
/api/agents/{name}/public-links	GET / POST	Public chat links

Loops and calls

Endpoint	Method	Description
/api/agents/{name}/loops	POST / GET	Start or list loops
/api/loops/{loop_id}	GET	Loop status
/api/loops/{loop_id}/stop	POST	Stop after the current iteration
/api/agents/{name}/voip	GET / PUT / DELETE	Phone-call binding
/api/agents/{name}/voip/call	POST	Place an outbound call

Fleet

Endpoint	Method	Description
/api/agents/context-stats	GET	Context usage for all agents
/api/agents/autonomy-status	GET	Autonomy for all agents
/api/executions	GET	Fleet execution list (status, triggered_by, hours, agent, search)
/api/executions/stats	GET	Fleet execution statistics