REST API

Cloud Only

The Cloud REST API is available at https://api.adhf.dev. Self-hosted users can access a local API at http://localhost:3847.

Authentication

All API requests require an API key:

curl -H "Authorization: Bearer adk_your_key" \
     https://api.adhf.dev/api/v1/daemons

Endpoints

List Daemons

GET /api/v1/daemons

Returns all connected machines.

List IDEs on a Machine

GET /api/v1/daemons/{daemonId}/ides

Send Message to Agent

POST /api/v1/agents/{ideId}/send

{
  "agentType": "cursor",
  "message": "Fix the login bug"
}

Approve/Reject Agent Action

POST /api/v1/agents/{ideId}/approve

{
  "agentType": "cursor",
  "approve": true
}

Read Current Chat

GET /api/v1/agents/{ideId}/chat

Take Screenshot

POST /api/v1/agents/{ideId}/screenshot

Returns a JPEG screenshot of the IDE.

Rate Limits

Plan	Monthly Calls
Free	1,000
Pro	50,000
Team	500,000
Enterprise	Unlimited

Error Codes

Code	Description
401	Invalid or missing API key
403	Action not permitted for this key's scope
404	Daemon or IDE not found
429	Rate limit exceeded
500	Server error