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/daemonsAvailable Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/daemons | List connected machines |
| GET | /api/v1/daemons/{daemonId}/status | Read the current machine snapshot |
| POST | /api/v1/shortcuts/{daemonId}/launch | Launch an IDE or CLI target |
| POST | /api/v1/shortcuts/{ideId}/chat | Send a message to an agent |
| POST | /api/v1/shortcuts/{ideId}/approve | Approve or reject an action |
| GET | /api/v1/shortcuts/{ideId}/chat | Read current chat |
| GET/POST | /api/v1/shortcuts/{ideId}/chat/debug | Build a sanitized chat debug bundle |
| GET | /api/v1/shortcuts/{ideId}/status | Read current agent status |
See the full API Reference →
Plan Limits
| Plan | API Keys | Monthly API Calls |
|---|---|---|
| Free | 3 | 1,000 |
| Pro | 10 | 50,000 |
| Ultra | 30 | 500,000 |
| Enterprise | Unlimited | Unlimited |
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
