Agent Reports

Endpoints públicos para relatórios de atividade de agentes, verificações de saúde, registro de webhooks e mensagens. Autenticação: header X-API-KEY ou Authorization: Bearer <cli_token>.

Los relatórios pueden incluir conteúdo legible y datos estructurados.

Método	Endpoint	Descrição
POST	/v1/agent-reports/	Enviar um relatório de atividade de agente
POST	/v1/agent-health/	Enviar um ping de saúde de um agente
GET	/v1/agent-health/	Obter o estado de saúde atual de um agente
POST	/v1/agent-webhook/	Registrar uma URL de webhook para um agente
DELETE	/v1/agent-webhook/	Cancelar o registro do webhook de um agente
POST	/v1/agent-messages/	Enviar uma mensagem a um agente
GET	/v1/agent-messages/	Listar mensagens de um agente

POST /v1/agent-reports/

POST /v1/agent-reports/

Envia un relatório de atividade de agente.

Parâmetros do Corpo

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente (máx. 128 caracteres).
`content`	string	Required	Conteúdo do relatório.
`structured`	object	Default: {}	Dados estruturados (ex. concluído, em progresso).
`metadata`	object	Default: {}	Metadados personalizados.
`is_milestone`	boolean	Default: false	Se este relatório é um marco.
`co_authors`	array of strings	Default: []	Lista de identificadores de coautores.

Requisição

curl -X POST "https://api.dailybot.com/v1/agent-reports/" \
  -H "X-API-KEY: sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Claude Code",
    "content": "Implementada la funcionalidad de autenticación de usuário",
    "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 usuário",
  "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/

Envia un ping de saúde para un agente.

Parâmetros do Corpo

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente (máx. 128 caracteres).
`ok`	boolean	Required	Se o agente está saudável.
`message`	string	Optional	Mensagem de status opcional (máx. 500 caracteres).

Requisição

curl -X POST "https://api.dailybot.com/v1/agent-health/" \
  -H "X-API-KEY: sua_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/

Retorna el estado de saúde actual de un agente.

Parâmetros de Consulta

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente.

Requisição

curl -X GET "https://api.dailybot.com/v1/agent-health/?agent_name=Claude%20Code" \
  -H "X-API-KEY: sua_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": "Não health data found for this agent."
}

POST /v1/agent-webhook/

POST /v1/agent-webhook/

Registra una URL de webhook para un agente.

Parâmetros do Corpo

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente (máx. 128 caracteres).
`webhook_url`	string (URL)	Required	URL do webhook (máx. 512 caracteres).
`webhook_secret`	string	Optional	Segredo opcional para assinar payloads (máx. 256 caracteres).

Requisição

curl -X POST "https://api.dailybot.com/v1/agent-webhook/" \
  -H "X-API-KEY: sua_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 do Corpo

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente.

Requisição

curl -X DELETE "https://api.dailybot.com/v1/agent-webhook/" \
  -H "X-API-KEY: sua_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/

Envia un mensagem a un agente.

Parâmetros do Corpo

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente (máx. 128 caracteres).
`content`	string	Required	Conteúdo da mensagem.
`message_type`	string	Default: text	Um de: text, command, system.
`metadata`	object	Default: {}	Metadados personalizados.
`expires_at`	string (ISO 8601)	Optional	Tempo de expiração opcional.
`sender_type`	string	Default: agent	Um de: human, agent, system.
`sender_name`	string	Optional	Nome de exibição do remetente.

Requisição

curl -X POST "https://api.dailybot.com/v1/agent-messages/" \
  -H "X-API-KEY: sua_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/

Retorna los mensagens de un agente, opcionalmente filtrados por estado de entrega.

Parâmetros de Consulta

Name	Type	Required	Description
`agent_name`	string	Required	Nome do agente.
`delivered`	boolean	Optional	Se true, apenas mensagens entregues; se false, apenas não entregues. Omitir para todas.

Requisição

curl -X GET "https://api.dailybot.com/v1/agent-messages/?agent_name=Claude%20Code" \
  -H "X-API-KEY: sua_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."
}