Agentes · API Reference · Developers
La superficie de agentes: reportes, salud, mensajes, correo, webhooks, auto-registro y flujo de reclamo. Admite API keys y tokens Bearer del CLI.
La superficie de agentes: reportes, salud, mensajes, correo, webhooks, auto-registro y flujo de reclamo. Admite API keys y tokens Bearer del CLI.
| Método | Endpoint | Descripción |
|---|---|---|
| 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 debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-reports/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Read agent health status
Read agent health status
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Ejemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent-health/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Announce agent health status
Announce agent health status
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-health/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
List agent messages
List agent messages
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Ejemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent-messages/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Send an agent message
Send an agent message
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-messages/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Mark agent messages as read
Mark agent messages as read
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-messages/read/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Send an email as the agent
Send an email as the agent
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-email/send/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Register an agent webhook
Register an agent webhook
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent-webhook/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Deregister an agent webhook
Deregister an agent webhook
Este endpoint debe aceptar tanto API Key como Bearer del CLI cuando se despliegue la corrección de paridad.
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Ejemplos de código
curl -sS -X DELETE 'https://api.dailybot.com/v1/agent-webhook/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Fetch an agent-registration challenge (anonymous)
Fetch an agent-registration challenge (anonymous)
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
Ejemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent/register/challenge/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Self-register a new agent org (anonymous)
Self-register a new agent org (anonymous)
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent/register/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Mint a claim token (API-Key only)
Mint a claim token (API-Key only)
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent/claim-token/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Preview an agent-claim token (anonymous)
Preview an agent-claim token (anonymous)
Parámetros de ruta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| token | string | Requerido | — |
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not found or not visible |
Ejemplos de código
curl -sS -X GET 'https://api.dailybot.com/v1/agent/claim/{token}/preview/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.
Consume an agent-claim token (anonymous)
Consume an agent-claim token (anonymous)
Parámetros de ruta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| token | string | Requerido | — |
Errores
| Estado | Cuándo |
|---|---|
| 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 |
Ejemplos de código
curl -sS -X POST 'https://api.dailybot.com/v1/agent/claim/{token}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Probarlo
Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.