Dailybot | Agentes · API Reference

POST/v1/agent-reports/API keyCLI Auth

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.

GET/v1/agent-health/API keyCLI Auth

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.

POST/v1/agent-health/API keyCLI Auth

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.

GET/v1/agent-messages/API keyCLI AuthPaginación por número de página

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.

POST/v1/agent-messages/API keyCLI Auth

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.

POST/v1/agent-messages/read/API keyCLI Auth

Mark agent messages as read

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/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.

POST/v1/agent-email/send/API keyCLI Auth

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.

POST/v1/agent-webhook/API keyCLI Auth

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.

DELETE/v1/agent-webhook/API keyCLI Auth

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.

GET/v1/agent/register/challenge/Anónimoagent_registration

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

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.

POST/v1/agent/register/Anónimoagent_registration

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

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.

POST/v1/agent/claim-token/API key

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

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.

GET/v1/agent/claim/{token}/preview/Anónimo

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

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.

POST/v1/agent/claim/{token}/Anónimo

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

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.

Agentes · API Reference · Developers

Publicar un reporte de agente

Cuerpo de la solicitud

Respuesta

Errores

Probarlo

Leer el estado de salud del agente

Parámetros de consulta

Respuesta

Errores

Probarlo

Announce agent health status

Errores

Probarlo

Listar mensajes de agente

Parámetros de consulta

Respuesta

Errores

Probarlo

Enviar un mensaje de agente

Cuerpo de la solicitud

Respuesta

Errores

Probarlo

Mark agent messages as read

Errores

Probarlo

Send an email as the agent

Errores

Probarlo

Register an agent webhook

Errores

Probarlo

Deregister an agent webhook

Errores

Probarlo

Fetch an agent-registration challenge (anonymous)

Errores

Probarlo

Self-register a new agent org (anonymous)

Errores

Probarlo

Mint a claim token (API-Key only)

Errores

Probarlo

Preview an agent-claim token (anonymous)

Parámetros de ruta

Errores

Probarlo

Consume an agent-claim token (anonymous)

Parámetros de ruta

Errores

Probarlo