Agentes · API Reference · Developers
A superfície de agentes: relatórios, saúde, mensagens, e-mail, webhooks, auto-registro e fluxo de reivindicação. Aceita chaves de API e tokens Bearer do CLI.
A superfície de agentes: relatórios, saúde, mensagens, e-mail, webhooks, auto-registro e fluxo de reivindicação. Aceita chaves de API e tokens Bearer do CLI.
| Método | Endpoint | Descrição |
|---|---|---|
| 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).
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-reports/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Read agent health status
Read agent health status
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent-health/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Announce agent health status
Announce agent health status
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-health/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
List agent messages
List agent messages
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent-messages/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Send an agent message
Send an agent message
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-messages/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Mark agent messages as read
Mark agent messages as read
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-messages/read/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Send an email as the agent
Send an email as the agent
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-email/send/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Register an agent webhook
Register an agent webhook
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-webhook/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Deregister an agent webhook
Deregister an agent webhook
Este endpoint deve aceitar tanto chave de API quanto Bearer do CLI após o deploy da correção de paridade.
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Exemplos de código
curl -sS -X DELETE 'https://api.dailybot.com/v1/agent-webhook/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Fetch an agent-registration challenge (anonymous)
Fetch an agent-registration challenge (anonymous)
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent/register/challenge/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Self-register a new agent org (anonymous)
Self-register a new agent org (anonymous)
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent/register/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Mint a claim token (API-Key only)
Mint a claim token (API-Key only)
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent/claim-token/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Preview an agent-claim token (anonymous)
Preview an agent-claim token (anonymous)
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| token | string | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Exemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent/claim/{token}/preview/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Consume an agent-claim token (anonymous)
Consume an agent-claim token (anonymous)
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| token | string | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 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 |
Exemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent/claim/{token}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.