API Reference

All REST endpoints served by the clawREFORM daemon on port 4332.

Method	Path	Purpose
GET	/api/health	Health check + version
GET	/api/agents	List all agents
POST	/api/agents/{id}/message	Send message to agent (triggers LLM)
GET	/api/budget	Global budget status
PUT	/api/budget	Update global budget limits
GET	/api/budget/agents	Per-agent cost ranking
GET	/api/budget/agents/{id}	Single agent budget detail
GET	/api/network/status	OFP network status
GET	/api/peers	Connected OFP peers
GET	/api/a2a/agents	External A2A agents
POST	/api/a2a/discover	Discover A2A agent at URL
POST	/api/a2a/send	Send task to external A2A agent
GET	/api/a2a/tasks/{id}/status	Check external task status

Example: Send a message

$ curl -X POST http://127.0.0.1:4332/api/agents/default/message \
  -H "Content-Type: application/json" \
  -d '{"message": "Summarize the Rust changelog in 3 bullets"}'

The agent routes the message to the configured LLM provider, executes any tool calls, and returns the final response. Budget is metered per call.

Configuration Core concepts