API Overview

Base URL

http://localhost:7777

For remote servers:

http://YOUR_SERVER_IP:7777

OSS version: No authentication required. Cloud version: API keys (coming soon).

Method	Endpoint	Description
`POST`	`/v1/deploy`	Deploy an agent
`POST`	`/v1/agents/{name}/run`	Execute an agent
`GET`	`/v1/agents`	List agents
`GET`	`/v1/agents/{name}/stats`	Get agent stats
`GET`	`/v1/execlog`	Query execution history (`?source=http\|mcp`)
`GET`	`/metrics`	Prometheus metrics
`DELETE`	`/v1/agents/{name}`	Undeploy agent

All responses are JSON:

{
  "data": { ... },
  "error": null
}

Or on error:

{
  "data": null,
  "error": "Error message"
}

Deploy:

curl -X POST http://localhost:7777/v1/deploy \
  -H "Content-Type: application/octet-stream" \
  --data-binary @agent.tar.gz

Run:

curl -X POST http://localhost:7777/v1/agents/my-agent/run \
  -H "Content-Type: application/json" \
  -d '{"input": {"query": "hello"}}'

Deploy endpoint details →