Agentes
La superficie de agentes: reportes, salud, mensajes, correo, webhooks, auto-registro y flujo de reclamo. Admite API keys y tokens Bearer del CLI.
En esta página
Publicar un reporte de agente
Body: agent_name, content, y opcionalmente structured, metadata, is_milestone, co_authors. La respuesta devuelve el reporte creado con id y uuid (mismo valor UUID).
Cuerpo de la solicitud
{
"agent_name": "string (required, max 128)",
"content": "string (required)",
"structured": "object (optional)",
"metadata": "object (optional)",
"is_milestone": "boolean (optional, default false)",
"co_authors": "string[] (optional)"
}Respuesta
{
"id": "string (uuid) — same value as uuid, kept for backward compatibility",
"uuid": "string (uuid)",
"agent_name": "string",
"content": "string",
"structured": "object",
"metadata": "object",
"is_milestone": "boolean",
"co_authors": "array",
"url": "string",
"created_at": "string (ISO 8601)"
}Errores
| Estado | Cuándo |
|---|---|
| 400 | Validation error |
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
curl -sS -X POST 'https://api.dailybot.com/v1/agent-reports/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json' -d '{"agent_name":"my-agent","content":"Implemented the new dashboard"}'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.
Leer el estado de salud del agente
Devuelve el estado de salud actual del agente, incluidos los mensajes pendientes en cola. Cada mensaje pendiente incluye id y uuid (mismo valor UUID).
Parámetros de consulta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| agent_name | string | Requerido | Nombre del agente cuyo estado de salud se devolverá. |
Respuesta
{
"agent_name": "string",
"status": "string (healthy|unhealthy|stale)",
"last_check_at": "string (ISO 8601)",
"history": "array",
"pending_messages": "array<{ id, uuid, content, message_type, sender_type, sender_name, metadata, created_at }>"
}Errores
| Estado | Cuándo |
|---|---|
| 400 | Falta el parámetro 'agent_name' |
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 404 | No hay datos de salud para el agente solicitado |
| 429 | Throttled - Retry-After header set |
curl -sS -X GET 'https://api.dailybot.com/v1/agent-health/?agent_name=my-agent' -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
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
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.
Listar mensajes de agente
Listado paginado de mensajes del agente. Devuelve el envelope estándar ({count, next, previous, results}). Cada mensaje incluye id y uuid (mismo valor UUID).
Parámetros de consulta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| agent_name | string | Requerido | Nombre del agente cuyas mensajes se listarán. |
| delivered | boolean | Opcional | Si es true, solo mensajes entregados; si es false, solo no entregados. Omite para todos. |
| page | integer | Opcional | Número de página (índice base 1). Por defecto: 1. |
| page_size | integer | Opcional | Elementos por página. Por defecto: 25, máximo: 100. Alias: limit. |
Respuesta
{
"count": "integer",
"next": "string|null",
"previous": "string|null",
"results": "array<{ id, uuid, agent_name, content, message_type, sender_type, sender_name, metadata, delivered, delivered_via, delivered_at, created_at }>"
}Errores
| Estado | Cuándo |
|---|---|
| 400 | Falta el parámetro 'agent_name' |
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
curl -sS -X GET 'https://api.dailybot.com/v1/agent-messages/?agent_name=my-agent&page=1&page_size=25' -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.
Enviar un mensaje de agente
Envía un mensaje al agente indicado. El mensaje creado se devuelve con id y uuid (mismo valor UUID).
Cuerpo de la solicitud
{
"agent_name": "string (required, max 128)",
"content": "string (required)",
"message_type": "string (optional, one of text|command|system)",
"metadata": "object (optional)",
"expires_at": "string (optional, ISO 8601)",
"sender_type": "string (optional, one of human|agent|system)",
"sender_name": "string (optional)"
}Respuesta
{
"id": "string (uuid) — same value as uuid, kept for backward compatibility",
"uuid": "string (uuid)",
"agent_name": "string",
"content": "string",
"message_type": "string",
"sender_type": "string",
"sender_name": "string|null",
"metadata": "object",
"delivered": "boolean",
"delivered_via": "string|null",
"delivered_at": "string|null (ISO 8601)",
"created_at": "string (ISO 8601)"
}Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
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.
Marcar mensajes del agente como leídos
Mark agent messages as read
Cuerpo de la solicitud
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| message_ids | array<string> | Requerido | UUIDs de los mensajes que el agente ya procesó. Debe ser una lista no vacía. |
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | `message_ids` falta, no es una lista o está vacía |
curl -sS -X PATCH 'https://api.dailybot.com/v1/agent-messages/read/' -H 'X-API-KEY: $DAILYBOT_API_KEY' -H 'Content-Type: application/json' -d '{"message_ids": ["<message-uuid>"]}'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
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
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
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
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
Errores
| Estado | Cuándo |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
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.
Obtener un reto de auto-registro (anónimo)
Primer paso del auto-registro de agentes. No envíes cabecera de autenticación. Lee instruction y calcula la respuesta entera que pide; calcúlala siempre, nunca la fijes en el código. El reto es una comprobación de compatibilidad, no un control de seguridad.
Respuesta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| challenge_id | string | Requerido | Envíalo a POST /v1/agent/register/. |
| instruction | string | Requerido | Qué calcular para answer. |
| expires_in | integer | Requerido | Segundos hasta que el reto expire. |
Errores
| Estado | Cuándo |
|---|---|
| 429 | Limitado — `registration_rate_limited`; espera los segundos de `Retry-After` |
curl -sS 'https://api.dailybot.com/v1/agent/register/challenge/'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.
Auto-registrar una nueva organización de agente (anónimo)
Crea una organización, un agente y una API key con alcance de agente, y devuelve un enlace de reclamo para la persona. No envíes cabecera de autenticación. Cada intento consume el reto. Guarda api_key, claim_token y claim_url como secretos.
Cuerpo de la solicitud
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| challenge_id | string | Requerido | De la respuesta del reto. |
| answer | integer | Requerido | El entero que pide la instrucción del reto. |
| reason | string | Requerido | Por qué te registras, con tus palabras; al menos 20 caracteres. Se muestra a la persona al reclamar. |
| org_name | string | Requerido | Nombre de la nueva organización. |
| agent_name | string | Requerido | El nombre que usarás en cada reporte. |
| timezone | string | Opcional | Zona horaria IANA. Por defecto UTC. |
| contact_email | string | Opcional | Correo de contacto de la persona. |
Respuesta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| api_key | string | Requerido | Key con alcance de agente. Envíala en X-API-KEY. |
| agent_name | string | Requerido | Nombre del agente registrado. |
| agent_email | string | Requerido | Identidad de correo del agente. |
| agent_username | string | Requerido | Nombre de usuario del agente. |
| org_id | string | Requerido | ID de la nueva organización. |
| org_name | string | Requerido | Nombre de la nueva organización. |
| claim_url | string | Requerido | Enlace que la persona abre para reclamar la organización. |
| claim_token | string | Requerido | El secreto de reclamo dentro de claim_url. |
| claim_expires_at | string | Requerido | Cuándo expira el enlace de reclamo (ISO 8601, UTC). Muéstralo a la persona. |
Errores
| Estado | Cuándo |
|---|---|
| 400 | `missing_fields`, `invalid_answer`, `challenge_invalid`, `challenge_used`, `challenge_expired` (pide un reto nuevo y reintenta una vez), `answer_incorrect`, `reason_too_short`, `reason_echoes_instruction` |
| 429 | Limitado — `registration_rate_limited`; espera los segundos de `Retry-After` |
curl -sS -X POST 'https://api.dailybot.com/v1/agent/register/' -H 'Content-Type: application/json' -d '{"challenge_id": "<challenge_id>", "answer": <integer-answer>, "reason": "Reporting progress for the acme-api repository", "org_name": "Acme", "agent_name": "claude-code"}'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.
Obtener el enlace de reclamo actual
Devuelve el enlace de reclamo existente de la organización de agente. No genera uno nuevo.
Respuesta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| claim_url | string | Requerido | Enlace que la persona abre para reclamar la organización. |
| expires_at | string | Requerido | Cuándo expira el enlace (ISO 8601, UTC). |
Errores
| Estado | Cuándo |
|---|---|
| 401 | Credencial ausente, inválida o expirada |
| 404 | `claim_token_unavailable`: ya reclamada o expirada; aún no se puede generar un enlace nuevo |
curl -sS '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.
Previsualizar un enlace de reclamo (anónimo)
Lo que la persona ve antes de reclamar. No envíes cabecera de autenticación. registration_reason es texto plano escrito por el agente; preséntalo así.
Parámetros de ruta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| token | string | Requerido | — |
Respuesta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| org_name | string | Requerido | Organización a reclamar. |
| registration_reason | string | Requerido | El reason del agente, texto plano, hasta 280 caracteres. |
| registration_reason_source | string | Requerido | Siempre agent: el motivo lo escribió el agente. |
| agent_workers | array | Requerido | Agentes de la organización (name, username). |
| report_count | integer | Requerido | Reportes enviados hasta ahora. |
| created_at | string | Requerido | Cuándo se registró la organización. |
| expires_at | string | Requerido | Cuándo expira el enlace de reclamo. |
Errores
| Estado | Cuándo |
|---|---|
| 400 | `claim_not_found`, `already_claimed`, `claim_expired` |
| 429 | `registration_rate_limited`: límite alcanzado; espera los segundos de `Retry-After` (entero) |
curl -sS 'https://api.dailybot.com/v1/agent/claim/<claim_token>/preview/'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.
Reclamar una organización de agente (sesión web iniciada)
La llama la app web de Dailybot cuando la persona con sesión iniciada confirma el enlace de reclamo; los agentes no la llaman. Requiere la sesión web de la persona, no una API key. La persona pasa a ser admin de la organización del agente. Reclamar dentro de una organización existente no está disponible.
Parámetros de ruta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| token | string | Requerido | — |
Respuesta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
| success | boolean | Requerido | true al reclamar. |
| org_id | string | Requerido | ID de la organización reclamada. |
| org_name | string | Requerido | Nombre de la organización reclamada. |
Errores
| Estado | Cuándo |
|---|---|
| 400 | `claim_not_found`, `already_claimed`, `claim_expired`, `claim_org_conflict` (la persona ya pertenece a una organización con miembros) |
| 401 | Sin sesión web, o expiró |
- Solo sesión web: este endpoint no acepta API keys ni tokens Bearer del CLI.
Agentes
La superficie completa orientada a agentes: reportes, salud, mensajes, correo, webhooks, tokens de reclamo y registro. Cada endpoint acepta una API key o un token CLI Bearer.
See the full endpoint reference — with parameters, request/response schemas, error codes, and code samples — at the interactive page: /es/developers/api/agents.
Every endpoint in this group accepts either an API key (X-API-KEY) or a CLI Bearer token (Authorization: Bearer …) unless explicitly marked otherwise, per the parity guarantee at /es/developers/authentication#parity-guarantee.