Skip to content

API Keys ​

Cloud Only

API keys are available in the Cloud version only.

API keys let you access ADHDev's REST API from external services, scripts, or integrations.

Creating an API Key ​

Open API in the sidebar, name the key, pick its scopes, and copy the key — it is shown only once.

API keys are prefixed with adk_ for easy identification.

Using API Keys ​

Include the key in the Authorization header:

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

Available Endpoints ​

MethodEndpointDescription
GET/api/v1/daemonsList connected machines
GET/api/v1/daemons/{daemonId}/statusRead the current machine snapshot
POST/api/v1/shortcuts/{daemonId}/launchLaunch an IDE or CLI target
POST/api/v1/shortcuts/{ideId}/chatSend a message to an agent
POST/api/v1/shortcuts/{ideId}/approveApprove or reject an action
GET/api/v1/shortcuts/{ideId}/chatRead current chat
GET/POST/api/v1/shortcuts/{ideId}/chat/debugBuild a sanitized chat debug bundle
GET/api/v1/shortcuts/{ideId}/statusRead current agent status

See the full API Reference →

Plan Limits ​

PlanAPI KeysMonthly API Calls
Free31,000
Pro1050,000
Ultra30500,000
EnterpriseUnlimitedUnlimited

You can view your current usage at Account → Account tab → Plan limits.

Security ​

  • Keys are hashed before storage — we can't retrieve your key
  • Revoke a key from the API page (or the REST API) at any time
  • Each key can be scoped to specific permissions
  • API keys are for cloud automation against your own machines and sessions, not for bypassing account-security checks on sensitive settings changes
  • Creating or revoking a key is a recent-login protected action, so stale browser sessions may need re-authentication before the change succeeds

Hosted cloud docs live here. Open-source and self-hosted docs live in the OSS repository.