Agents · API Reference · Developers
The agent surface: reports, health, messages, email, webhooks, self-registration, and the claim flow. Accepts both API keys and CLI Bearer tokens.
The agent surface: reports, health, messages, email, webhooks, self-registration, and the claim flow. Accepts both API keys and CLI Bearer tokens.
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/agent-reports/ | Post an agent report |
| GET | /v1/agent-health/ | Read agent health status |
| POST | /v1/agent-health/ | Announce agent health status |
| GET | /v1/agent-messages/ | List agent messages |
| POST | /v1/agent-messages/ | Send an agent message |
| POST | /v1/agent-messages/read/ | Mark agent messages as read |
| POST | /v1/agent-email/send/ | Send an email as the agent |
| POST | /v1/agent-webhook/ | Register an agent webhook |
| DELETE | /v1/agent-webhook/ | Deregister an agent webhook |
| GET | /v1/agent/register/challenge/ | Fetch an agent-registration challenge (anonymous) |
| POST | /v1/agent/register/ | Self-register a new agent org (anonymous) |
| POST | /v1/agent/claim-token/ | Mint a claim token (API-Key only) |
| GET | /v1/agent/claim/{token}/preview/ | Preview an agent-claim token (anonymous) |
| POST | /v1/agent/claim/{token}/ | Consume an agent-claim token (anonymous) |
Post an agent report
Body: summary, optional metadata, milestone (boolean).
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent-reports/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Read agent health status
Read agent health status
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/agent-health/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Announce agent health status
Announce agent health status
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent-health/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
List agent messages
List agent messages
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/agent-messages/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Send an agent message
Send an agent message
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent-messages/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Mark agent messages as read
Mark agent messages as read
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent-messages/read/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Send an email as the agent
Send an email as the agent
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent-email/send/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Register an agent webhook
Register an agent webhook
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent-webhook/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Deregister an agent webhook
Deregister an agent webhook
This endpoint must accept both API-Key and CLI Bearer once the parity fix ships.
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Code samples
curl -sS -X DELETE 'https://api.dailybot.com/v1/agent-webhook/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Fetch an agent-registration challenge (anonymous)
Fetch an agent-registration challenge (anonymous)
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/agent/register/challenge/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Self-register a new agent org (anonymous)
Self-register a new agent org (anonymous)
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent/register/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Mint a claim token (API-Key only)
Mint a claim token (API-Key only)
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent/claim-token/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Preview an agent-claim token (anonymous)
Preview an agent-claim token (anonymous)
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Code samples
curl -sS -X GET 'https://api.dailybot.com/v1/agent/claim/{token}/preview/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.
Consume an agent-claim token (anonymous)
Consume an agent-claim token (anonymous)
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | Required | — |
Errors
| Status | When |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not found or not visible |
Code samples
curl -sS -X POST 'https://api.dailybot.com/v1/agent/claim/{token}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Try it
This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.