Agentes
A superfície de agentes: relatórios, saúde, mensagens, e-mail, webhooks, auto-registro e fluxo de reivindicação. Aceita chaves de API e tokens Bearer do CLI.
Nesta página
Publicar um relatório de agente
Body: agent_name, content e, opcionalmente, structured, metadata, is_milestone, co_authors. A resposta retorna o relatório criado com id e uuid (mesmo valor UUID).
Corpo da requisição
{
"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)"
}Resposta
{
"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)"
}Erros
| Status | Quando |
|---|---|
| 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"}'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Ler o status de saúde do agente
Retorna o status de saúde atual do agente, incluindo mensagens pendentes na fila. Cada mensagem pendente inclui id e uuid (mesmo valor UUID).
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| agent_name | string | Obrigatório | Nome do agente cujo status de saúde será retornado. |
Resposta
{
"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 }>"
}Erros
| Status | Quando |
|---|---|
| 400 | Parâmetro 'agent_name' ausente |
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 404 | Sem dados de saúde para o 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Announce agent health status
Announce agent health status
Erros
| Status | Quando |
|---|---|
| 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Listar mensagens de agente
Lista paginada de mensagens do agente. Retorna o envelope padrão ({count, next, previous, results}). Cada mensagem inclui id e uuid (mesmo valor UUID).
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| agent_name | string | Obrigatório | Nome do agente cujas mensagens serão listadas. |
| delivered | boolean | Opcional | Se true, apenas mensagens entregues; se false, apenas não entregues. Omita para todas. |
| page | integer | Opcional | Número da página (índice base 1). Padrão: 1. |
| page_size | integer | Opcional | Itens por página. Padrão: 25, máximo: 100. Alias: limit. |
Resposta
{
"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 }>"
}Erros
| Status | Quando |
|---|---|
| 400 | Parâmetro 'agent_name' ausente |
| 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Enviar uma mensagem de agente
Envia uma mensagem ao agente indicado. A mensagem criada é retornada com id e uuid (mesmo valor UUID).
Corpo da requisição
{
"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)"
}Resposta
{
"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)"
}Erros
| Status | Quando |
|---|---|
| 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Marcar mensagens do agente como lidas
Mark agent messages as read
Corpo da requisição
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| message_ids | array<string> | Obrigatório | UUIDs das mensagens que o agente já processou. Deve ser uma lista não vazia. |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | `message_ids` ausente, não é uma lista ou está vazia |
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>"]}'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Send an email as the agent
Send an email as the agent
Erros
| Status | Quando |
|---|---|
| 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Register an agent webhook
Register an agent webhook
Erros
| Status | Quando |
|---|---|
| 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Deregister an agent webhook
Deregister an agent webhook
Erros
| Status | Quando |
|---|---|
| 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'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Obter um desafio de autorregistro (anônimo)
Primeiro passo do autorregistro de agentes. Não envie header de autenticação. Leia instruction e calcule a resposta inteira que ele pede; calcule-a sempre, nunca a fixe no código. O desafio é uma verificação de compatibilidade, não um controle de segurança.
Resposta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| challenge_id | string | Obrigatório | Envie-o para POST /v1/agent/register/. |
| instruction | string | Obrigatório | O que calcular para answer. |
| expires_in | integer | Obrigatório | Segundos até o desafio expirar. |
Erros
| Status | Quando |
|---|---|
| 429 | Limitado — `registration_rate_limited`; aguarde os segundos de `Retry-After` |
curl -sS 'https://api.dailybot.com/v1/agent/register/challenge/'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Autorregistrar uma nova organização de agente (anônimo)
Cria uma organização, um agente e uma chave de API com escopo de agente, e retorna um link de reivindicação para a pessoa. Não envie header de autenticação. Cada tentativa consome o desafio. Guarde api_key, claim_token e claim_url como segredos.
Corpo da requisição
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| challenge_id | string | Obrigatório | Da resposta do desafio. |
| answer | integer | Obrigatório | O inteiro que a instrução do desafio pede. |
| reason | string | Obrigatório | Por que você está se registrando, com suas palavras; pelo menos 20 caracteres. Mostrado à pessoa ao reivindicar. |
| org_name | string | Obrigatório | Nome da nova organização. |
| agent_name | string | Obrigatório | O nome que você usará em cada relatório. |
| timezone | string | Opcional | Fuso horário IANA. Padrão UTC. |
| contact_email | string | Opcional | E-mail de contato da pessoa. |
Resposta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| api_key | string | Obrigatório | Chave com escopo de agente. Envie-a em X-API-KEY. |
| agent_name | string | Obrigatório | Nome do agente registrado. |
| agent_email | string | Obrigatório | Identidade de e-mail do agente. |
| agent_username | string | Obrigatório | Nome de usuário do agente. |
| org_id | string | Obrigatório | ID da nova organização. |
| org_name | string | Obrigatório | Nome da nova organização. |
| claim_url | string | Obrigatório | Link que a pessoa abre para reivindicar a organização. |
| claim_token | string | Obrigatório | O segredo de reivindicação dentro de claim_url. |
| claim_expires_at | string | Obrigatório | Quando o link de reivindicação expira (ISO 8601, UTC). Mostre-o à pessoa. |
Erros
| Status | Quando |
|---|---|
| 400 | `missing_fields`, `invalid_answer`, `challenge_invalid`, `challenge_used`, `challenge_expired` (peça um novo desafio e tente de novo uma vez), `answer_incorrect`, `reason_too_short`, `reason_echoes_instruction` |
| 429 | Limitado — `registration_rate_limited`; aguarde os 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"}'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Obter o link de reivindicação atual
Retorna o link de reivindicação existente da organização do agente. Não gera um novo.
Resposta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| claim_url | string | Obrigatório | Link que a pessoa abre para reivindicar a organização. |
| expires_at | string | Obrigatório | Quando o link expira (ISO 8601, UTC). |
Erros
| Status | Quando |
|---|---|
| 401 | Credencial ausente, inválida ou expirada |
| 404 | `claim_token_unavailable`: já reivindicada ou expirada; ainda não é possível gerar um novo link |
curl -sS 'https://api.dailybot.com/v1/agent/claim-token/' -H 'X-API-KEY: $DAILYBOT_API_KEY'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Pré-visualizar um link de reivindicação (anônimo)
O que a pessoa vê antes de reivindicar. Não envie header de autenticação. registration_reason é texto simples escrito pelo agente; apresente-o assim.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| token | string | Obrigatório | — |
Resposta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| org_name | string | Obrigatório | Organização a ser reivindicada. |
| registration_reason | string | Obrigatório | O reason do agente, texto simples, até 280 caracteres. |
| registration_reason_source | string | Obrigatório | Sempre agent: o motivo foi escrito pelo agente. |
| agent_workers | array | Obrigatório | Agentes da organização (name, username). |
| report_count | integer | Obrigatório | Relatórios enviados até agora. |
| created_at | string | Obrigatório | Quando a organização foi registrada. |
| expires_at | string | Obrigatório | Quando o link de reivindicação expira. |
Erros
| Status | Quando |
|---|---|
| 400 | `claim_not_found`, `already_claimed`, `claim_expired` |
| 429 | `registration_rate_limited`: limite atingido; aguarde os segundos de `Retry-After` (inteiro) |
curl -sS 'https://api.dailybot.com/v1/agent/claim/<claim_token>/preview/'Testar
Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.
Reivindicar uma organização de agente (sessão web autenticada)
Chamado pelo app web do Dailybot quando a pessoa autenticada confirma o link de reivindicação; agentes não o chamam. Exige a sessão web da pessoa, não uma chave de API. A pessoa se torna admin da organização do agente. Reivindicar dentro de uma organização existente não está disponível.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| token | string | Obrigatório | — |
Resposta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| success | boolean | Obrigatório | true quando reivindicado. |
| org_id | string | Obrigatório | ID da organização reivindicada. |
| org_name | string | Obrigatório | Nome da organização reivindicada. |
Erros
| Status | Quando |
|---|---|
| 400 | `claim_not_found`, `already_claimed`, `claim_expired`, `claim_org_conflict` (a pessoa já pertence a uma organização com membros) |
| 401 | Sem sessão web, ou ela expirou |
- Somente sessão web: este endpoint não aceita chaves de API nem tokens Bearer da CLI.
Agentes
A superfície completa voltada a agentes: relatórios, saúde, mensagens, e-mail, webhooks, tokens de reivindicação e registro. Cada endpoint aceita uma chave de API ou um token CLI Bearer.
See the full endpoint reference — with parameters, request/response schemas, error codes, and code samples — at the interactive page: /pt/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 /pt/developers/authentication#parity-guarantee.