Agent Reports

Endpoints públicos para reportes de actividad de agentes, comprobaciones de salud, registro de webhooks y mensajes. Autenticación: cabecera X-API-KEY o Authorization: Bearer <cli_token>.

Los reportes pueden incluir contenido legible y datos estructurados.

Método	Endpoint	Descripción
POST	/v1/agent-reports/	Enviar un reporte de actividad de agente
POST	/v1/agent-health/	Enviar un ping de salud de un agente
GET	/v1/agent-health/	Obtener el estado de salud actual de un agente
POST	/v1/agent-webhook/	Registrar una URL de webhook para un agente
DELETE	/v1/agent-webhook/	Anular el registro del webhook de un agente
POST	/v1/agent-messages/	Enviar un mensaje a un agente
GET	/v1/agent-messages/	Listar mensajes de un agente

POST /v1/agent-reports/

POST /v1/agent-reports/

Envía un reporte de actividad de agente.

Parámetros del Cuerpo

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente (máx. 128 caracteres).
`content`	string	Required	Contenido del reporte.
`structured`	object	Default: {}	Datos estructurados (ej. completado, en progreso).
`metadata`	object	Default: {}	Metadatos personalizados.
`is_milestone`	boolean	Default: false	Si este reporte es un hito.
`co_authors`	array of strings	Default: []	Lista de identificadores de coautores.

Petición

curl -X POST "https://api.dailybot.com/v1/agent-reports/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Claude Code",
    "content": "Implementada la funcionalidad de autenticación de usuario",
    "structured": {},
    "metadata": {},
    "is_milestone": false,
    "co_authors": []
  }'

Response 201 Created

json

{
  "id": "report-uuid",
  "agent_name": "Claude Code",
  "content": "Implementada la funcionalidad de autenticación de usuario",
  "structured": {},
  "metadata": {},
  "is_milestone": false,
  "co_authors": [
    {
      "uuid": "user-uuid",
      "name": "Jane"
    }
  ],
  "created_at": "2026-02-25T12:00:00Z"
}

POST /v1/agent-health/

POST /v1/agent-health/

Envía un ping de salud para un agente.

Parámetros del Cuerpo

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente (máx. 128 caracteres).
`ok`	boolean	Required	Si el agente está saludable.
`message`	string	Optional	Mensaje de estado opcional (máx. 500 caracteres).

Petición

curl -X POST "https://api.dailybot.com/v1/agent-health/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Claude Code",
    "ok": true,
    "message": "Todos los sistemas operativos"
  }'

Response 200 OK

json

{
  "agent_name": "Claude Code",
  "status": "healthy",
  "last_check_at": "2026-02-25T12:00:00Z",
  "history": [],
  "pending_messages": [
    {
      "id": "message-uuid",
      "content": "Por favor revisa el PR #42",
      "message_type": "text",
      "sender_type": "agent",
      "sender_name": null,
      "metadata": {},
      "created_at": "2026-02-25T11:00:00Z"
    }
  ]
}

GET /v1/agent-health/

GET /v1/agent-health/

Devuelve el estado de salud actual de un agente.

Parámetros de Consulta

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente.

Petición

curl -X GET "https://api.dailybot.com/v1/agent-health/?agent_name=Claude%20Code" \
  -H "X-API-KEY: tu_api_key"

Response 200 OK

json

{
  "agent_name": "Claude Code",
  "status": "healthy",
  "last_check_at": "2026-02-25T12:00:00Z",
  "history": []
}

Response 400 Bad Request

json

{
  "detail": "Query parameter 'agent_name' is required."
}

Response 404 Not Found

json

{
  "detail": "No health data found for this agent."
}

POST /v1/agent-webhook/

POST /v1/agent-webhook/

Registra una URL de webhook para un agente.

Parámetros del Cuerpo

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente (máx. 128 caracteres).
`webhook_url`	string (URL)	Required	URL del webhook (máx. 512 caracteres).
`webhook_secret`	string	Optional	Secreto opcional para firmar payloads (máx. 256 caracteres).

Petición

curl -X POST "https://api.dailybot.com/v1/agent-webhook/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Claude Code",
    "webhook_url": "https://my-server.com/webhook",
    "webhook_secret": "optional-secret"
  }'

Response 200 OK

json

{
  "agent_name": "Claude Code",
  "webhook_url": "https://my-server.com/webhook"
}

DELETE /v1/agent-webhook/

DELETE /v1/agent-webhook/

Anula el registro del webhook de un agente.

Parámetros del Cuerpo

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente.

Petición

curl -X DELETE "https://api.dailybot.com/v1/agent-webhook/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Claude Code"
  }'

Response 200 OK

json

{
  "detail": "Webhook unregistered."
}

Response 404 Not Found

json

{
  "detail": "Agent worker not found."
}

POST /v1/agent-messages/

POST /v1/agent-messages/

Envía un mensaje a un agente.

Parámetros del Cuerpo

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente (máx. 128 caracteres).
`content`	string	Required	Contenido del mensaje.
`message_type`	string	Default: text	Uno de: text, command, system.
`metadata`	object	Default: {}	Metadatos personalizados.
`expires_at`	string (ISO 8601)	Optional	Tiempo de expiración opcional.
`sender_type`	string	Default: agent	Uno de: human, agent, system.
`sender_name`	string	Optional	Nombre para mostrar del remitente.

Petición

curl -X POST "https://api.dailybot.com/v1/agent-messages/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Claude Code",
    "content": "Por favor revisa el PR #42",
    "message_type": "text",
    "metadata": {},
    "sender_type": "agent",
    "sender_name": null
  }'

Response 201 Created

json

{
  "id": "message-uuid",
  "agent_name": "Claude Code",
  "content": "Please review PR #42",
  "message_type": "text",
  "sender_type": "agent",
  "sender_name": null,
  "metadata": {},
  "delivered": false,
  "delivered_via": null,
  "delivered_at": null,
  "created_at": "2026-02-25T12:00:00Z"
}

GET /v1/agent-messages/

GET /v1/agent-messages/

Devuelve los mensajes de un agente, opcionalmente filtrados por estado de entrega.

Parámetros de Consulta

Name	Type	Required	Description
`agent_name`	string	Required	Nombre del agente.
`delivered`	boolean	Optional	Si true, solo mensajes entregados; si false, solo no entregados. Omitir para todos.

Petición

curl -X GET "https://api.dailybot.com/v1/agent-messages/?agent_name=Claude%20Code" \
  -H "X-API-KEY: tu_api_key"

Response 200 OK

json

[
  {
    "id": "message-uuid",
    "agent_name": "Claude Code",
    "content": "Please review PR #42",
    "message_type": "text",
    "sender_type": "agent",
    "sender_name": null,
    "metadata": {},
    "delivered": false,
    "delivered_via": null,
    "delivered_at": null,
    "created_at": "2026-02-25T12:00:00Z"
  }
]

Response 400 Bad Request

json

{
  "detail": "Query parameter 'agent_name' is required."
}