Dailybot | Plan · Comentários e arquivos

Comentários, reações, anexos e o feed de atividade e registro de eventos de cada tarefa. Parte da API do Dailybot Plan (Beta).

Beta

Plan está em beta. Tudo o que está em /plan no aplicativo web, os comandos da CLI e da agent skill para projetos, metas, quadros e tarefas, e a API pública /v1/plan/ podem mudar antes da disponibilidade geral. Quer testar com sua equipe? Escreva para [email protected].

GET/v1/plan/tasks/{task_id}/comments/BetaChave de APICLI AuthPaginação por número de página

Listar os comentários de uma tarefa

Os comentários da tarefa, do mais antigo ao mais recente, em uma página. Cada comentário traz as reações e os attachments prontos. Use updated_since para buscar só o que mudou desde a sua última leitura.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
page	integer	Opcional	Número da página, começando em 1.
page_size	integer	Opcional	Linhas por página. Padrão 50, máximo 100. Valores fora do intervalo são ajustados, nunca rejeitados: pedir 500 retorna 100.
updated_since	string	Opcional	Um filtro de timestamp nesta lista paginada: retorna `{count, next, previous, results}`, nunca um cursor. Para um feed de mudanças, use o endpoint delta do quadro.

Objeto TaskComment

Nome	Tipo	Obrigatório	Descrição
uuid	uuid	Obrigatório	Identificador público estável.
body	string	Obrigatório	Markdown como digitado. Mencione alguém com `<@DB@{uuid}>`, usando um `uuid` da lista de mencionáveis. Máx. 10000 caracteres.
author	ActorRef \| null	Obrigatório	Quem escreveu o comentário. Veja ActorRef.
executed_by_agent	object \| null	Opcional	O agente que executou isto em nome da pessoa, ou `null` quando nenhum foi nomeado: um objeto com `uuid`, `name`, `username` e `avatar`. A pessoa do campo de autor continua sendo a autora; o agente é mostrado como quem executou.
mentions	array<ActorRef>	Opcional	As pessoas mencionadas. Leia-as daqui, nunca analisando `body`. Veja ActorRef.
body_html	string	Opcional	`body` renderizado e sanitizado pelo servidor. HTML do cliente nunca é aceito.
reactions	array	Opcional	Reações com emoji, indicando se você reagiu. Todos os campos estão sempre presentes. Itens: `{emoji: string, count: integer, reacted: boolean}`.
provenance	enum	Obrigatório	`typed` por uma pessoa, `agent_authored` ou `retrieved` de outro sistema. Um de `typed`, `agent_authored`, `retrieved`.
parent_comment	uuid \| null	Opcional	O comentário ao qual este responde. Apenas um nível de encadeamento.
edited_at	date-time \| null	Opcional	Quando o comentário foi editado pela última vez.
is_deleted	boolean	Opcional	Comentários excluídos mantêm sua linha com o corpo em branco.
created_at	date-time	Obrigatório	Quando a linha foi criada.
attachments	array<TaskAttachment>	Opcional	Os anexos prontos do comentário, ordenados por posição. Veja TaskAttachment.

Objeto ActorRef

Nome	Tipo	Obrigatório	Descrição
kind	string	Obrigatório	—
uuid	string	Obrigatório	Identificador público estável.
name	string	Opcional	Nome de exibição.
username	string \| null	Opcional	—
avatar_url	string \| null	Opcional	—
has_photo	boolean	Opcional	—

Objeto TaskAttachment

Nome	Tipo	Obrigatório	Descrição
uuid	uuid	Obrigatório	Identificador público estável.
filename	string	Obrigatório	Nome do arquivo.
content_type	string	Obrigatório	Tipo MIME.
size	integer	Obrigatório	Tamanho em bytes.
url	string	Obrigatório	Onde baixar o arquivo.
thumbnail_url	uri \| null	Opcional	Miniatura para imagens.
width	integer \| null	Opcional	—
height	integer \| null	Opcional	—
status	enum	Obrigatório	Status atual. Um de `pending`, `ready`, `scanning`, `rejected`.
uploaded_by	ActorRef \| null	Opcional	Quem enviou o arquivo. Veja ActorRef.
executed_by_agent	object \| null	Opcional	O agente que executou isto em nome da pessoa, ou `null` quando nenhum foi nomeado: um objeto com `uuid`, `name`, `username` e `avatar`. A pessoa do campo de autor continua sendo a autora; o agente é mostrado como quem executou.
created_at	date-time	Obrigatório	Quando a linha foi criada.

Resposta

Nome	Tipo	Obrigatório	Descrição
count	integer	Obrigatório	Número total de linhas.
next	uri	Obrigatório	URL da próxima página, ou `null`.
previous	uri	Obrigatório	URL da página anterior, ou `null`.
results	array<TaskComment>	Obrigatório	As linhas desta página. Veja TaskComment.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task comments ENG-142 --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000008",
      "body": "Staging is green; rolling out Friday.",
      "author": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "mentions": [],
      "body_html": "<p>Staging is green; rolling out Friday.</p>",
      "reactions": [],
      "provenance": "typed",
      "parent_comment": null,
      "edited_at": null,
      "is_deleted": false,
      "created_at": "2026-09-25T10:14:02Z",
      "attachments": []
    }
  ]
}

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

POST/v1/plan/tasks/{task_id}/comments/BetaChave de APICLI Auth

Comentar em uma tarefa

Adiciona um comentário à tarefa. Mencione alguém com <@DB@{uuid}>, usando um uuid das pessoas mencionáveis do quadro. Envie um Idempotency-Key para repetir com segurança.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
Idempotency-Key	string	Opcional	Uma chave que você gera para esta intenção. Uma repetição com a mesma chave e o mesmo corpo retorna a primeira resposta sem um segundo efeito colateral e traz `Idempotency-Replayed: true`. As chaves são mantidas por 24 horas. A mesma chave com um corpo diferente é `409 idempotency_key_payload_mismatch`; uma repetição enquanto a primeira chamada ainda está em execução recebe `409 idempotency_in_progress` por até 120 segundos.
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
body	string	Obrigatório	Markdown. Mencione alguém com `<@DB@{uuid}>`, usando um `uuid` da lista de mencionáveis. Máx. 10000 caracteres.
parent_comment	uuid \| null	Opcional	O comentário ao qual este responde. Apenas um nível de encadeamento.
agent_name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa (máx. 128 caracteres, vazio significa sem agente). Tem prioridade sobre o header `X-Dailybot-Agent-Name`. Veja Atribuição de agente.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskComment	Obrigatório	Um objeto TaskComment.

Erros

Status	Quando
400	A validação falhou, ou um valor de filtro, ordenação ou `include` não foi reconhecido. O `code` da resposta indica qual. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Looks good. <@DB@00000000-0000-4000-8000-00000000000c> can you review the rollout plan?"
  }'

dailybot plan task comment ENG-142 "Deployed. <@DB@00000000-0000-4000-8000-00000000000c> can you verify?"

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

PATCH/v1/plan/tasks/{task_id}/comments/{comment_id}/BetaChave de APICLI Auth

Editar um comentário

Edita o corpo de um comentário. Só o autor pode editá-lo (403 comment_not_author); a resposta define edited_at.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
body	string	Obrigatório	Markdown. Mencione alguém com `<@DB@{uuid}>`, usando um `uuid` da lista de mencionáveis. Máx. 10000 caracteres.
parent_comment	uuid \| null	Opcional	O comentário ao qual este responde. Apenas um nível de encadeamento.
agent_name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa (máx. 128 caracteres, vazio significa sem agente). Tem prioridade sobre o header `X-Dailybot-Agent-Name`. Veja Atribuição de agente.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskComment	Obrigatório	Um objeto TaskComment.

Erros

Status	Quando
400	O nome do agente não é válido (`invalid_agent_attribution`).
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
403	Autenticado, mas sem permissão: falta o scope (`insufficient_scope`, que é também o que uma key de agente ou da organização recebe em uma operação que exige uma pessoa, e o que uma key pessoal recebe quando seus scopes de Plan explícitos não cobrem o endpoint) ou é uma conta de convidado (`guest_not_allowed`).
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X PATCH "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Looks good. Rollout plan attached."
  }'

dailybot plan task comment-edit ENG-142 00000000-0000-4000-8000-000000000008 "Deployed to production"

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

DELETE/v1/plan/tasks/{task_id}/comments/{comment_id}/BetaChave de APICLI Auth

Excluir um comentário

Uma exclusão lógica: a linha permanece para que seus eventos continuem resolvendo, e o corpo fica em branco.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Erros

Status	Quando
400	O nome do agente não é válido (`invalid_agent_attribution`).
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
403	Autenticado, mas sem permissão: falta o scope (`insufficient_scope`, que é também o que uma key de agente ou da organização recebe em uma operação que exige uma pessoa, e o que uma key pessoal recebe quando seus scopes de Plan explícitos não cobrem o endpoint) ou é uma conta de convidado (`guest_not_allowed`).
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X DELETE "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task comment-delete ENG-142 00000000-0000-4000-8000-000000000008 --yes

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

POST/v1/plan/tasks/{task_id}/comments/{comment_id}/reactions/BetaChave de APICLI Auth

Adicionar uma reação com emoji a um comentário (idempotente)

Adiciona a sua reação emoji ao comentário. É idempotente: adicionar a mesma reação de novo não muda nada. A resposta é o comentário com as reações atualizadas.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
emoji	string	Obrigatório	O emoji. Máx. 32 caracteres.
agent_name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa (máx. 128 caracteres, vazio significa sem agente). Tem prioridade sobre o header `X-Dailybot-Agent-Name`. Veja Atribuição de agente.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskComment	Obrigatório	Um objeto TaskComment.

Erros

Status	Quando
400	A validação falhou, ou um valor de filtro, ordenação ou `include` não foi reconhecido. O `code` da resposta indica qual. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/reactions/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "👍"
  }'

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

DELETE/v1/plan/tasks/{task_id}/comments/{comment_id}/reactions/{emoji}/BetaChave de APICLI Auth

Remover a reação com emoji de quem chama em um comentário

Remove a sua reação com este emoji do comentário. Responde 204 mesmo quando a reação já não existia.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.
emoji	string	Obrigatório	O emoji a remover, como foi enviado ao adicioná-lo (máx. 32 caracteres), codificado para URL no caminho.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Erros

Status	Quando
400	A validação falhou, ou um valor de filtro, ordenação ou `include` não foi reconhecido. O `code` da resposta indica qual. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X DELETE "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/reactions/%F0%9F%91%8D/" \
  -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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/comments/{comment_id}/attachments/BetaChave de APICLI AuthPaginação por número de página

Listar os anexos de um comentário

Os anexos do comentário, ordenados por posição. O próprio comentário já traz os anexos prontos em attachments. Cada url é um link de download. Não o guarde: mantenha o uuid do anexo e leia de novo quando precisar do arquivo.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
page	integer	Opcional	Número da página, começando em 1.
page_size	integer	Opcional	Linhas por página. Padrão 50, máximo 100. Valores fora do intervalo são ajustados, nunca rejeitados: pedir 500 retorna 100.

Resposta

Nome	Tipo	Obrigatório	Descrição
count	integer	Obrigatório	Número total de linhas.
next	uri	Obrigatório	URL da próxima página, ou `null`.
previous	uri	Obrigatório	URL da página anterior, ou `null`.
results	array<TaskAttachment>	Obrigatório	As linhas desta página. Veja TaskAttachment.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	A tarefa, o comentário ou o anexo não existe ou você não pode vê-lo (`not_found`), nunca um 403.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/attachments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task comment-attachments ENG-142 00000000-0000-4000-8000-000000000008 --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000009",
      "filename": "screenshot.png",
      "content_type": "image/png",
      "size": 1,
      "url": "https://your.app/files/screenshot.png",
      "thumbnail_url": null,
      "width": null,
      "height": null,
      "status": "ready",
      "uploaded_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "created_at": "2026-09-25T10:14:02Z"
    }
  ]
}

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

POST/v1/plan/tasks/{task_id}/comments/{comment_id}/attachments/BetaChave de APICLI Auth

Enviar um anexo para um comentário

Anexa um arquivo a um comentário. Somente o autor do comentário pode anexar arquivos a ele. Envie multipart/form-data com o campo file e um caption opcional; aqui não há fluxo de pré-assinatura. O limite é de 5 MiB em todos os ambientes: um arquivo maior é 400 attachment_too_large, com extra.max_size_bytes. O tipo de arquivo é verificado pelo conteúdo contra a mesma lista dos anexos de tarefas (attachment_invalid_type). Um comentário aceita no máximo 50 anexos (attachment_limit_reached).

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
file	binary	Obrigatório	O arquivo a enviar (máximo de 5 MiB por esta via).
caption	string	Opcional	Legenda opcional. Máximo de 255 caracteres.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskAttachment	Obrigatório	Um objeto TaskAttachment.

Erros

Status	Quando
400	O arquivo está ausente, é grande demais (`attachment_too_large`, acima de 5 MiB), tem um tipo não aceito (`attachment_invalid_type`) ou o limite de 50 foi atingido (`attachment_limit_reached`). `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
403	Você não é o autor do comentário (`comment_not_author`).
404	A tarefa, o comentário ou o anexo não existe ou você não pode vê-lo (`not_found`), nunca um 403.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/attachments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -F "file=@./screenshot.png" \
  -F "caption=Staging dashboard"

dailybot plan task comment-attach ENG-142 00000000-0000-4000-8000-000000000008 ./trace.txt --caption "Stack trace"

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/comments/{comment_id}/attachments/{attachment_id}/content/BetaChave de APICLI Auth

Baixar os bytes de um anexo de um comentário

Transmite o arquivo com o tipo de conteúdo registrado no envio, X-Content-Type-Options: nosniff e Cache-Control: no-store. Nunca redireciona para o armazenamento. Autorizado como qualquer outra leitura da tarefa.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.
attachment_id	string	Obrigatório	O uuid do anexo.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	A tarefa, o comentário ou o anexo não existe ou você não pode vê-lo (`not_found`), nunca um 403.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task comment-attachment get ENG-142 00000000-0000-4000-8000-000000000008 00000000-0000-4000-8000-000000000009 -o ./trace.txt

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

DELETE/v1/plan/tasks/{task_id}/comments/{comment_id}/attachments/{attachment_id}/BetaChave de APICLI Auth

Remover um anexo de um comentário

Remove o anexo do comentário. Podem fazer isso quem o enviou, o autor do comentário ou um administrador da organização.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.
attachment_id	string	Obrigatório	O uuid do anexo.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Erros

Status	Quando
400	O nome do agente não é válido (`invalid_agent_attribution`).
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
403	Você não é quem o enviou, o autor do comentário nem um administrador da organização (`attachment_delete_forbidden`).
404	A tarefa, o comentário ou o anexo não existe ou você não pode vê-lo (`not_found`), nunca um 403.

curl -sS -X DELETE "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task comment-attachment delete ENG-142 00000000-0000-4000-8000-000000000008 00000000-0000-4000-8000-000000000009 --yes

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/attachments/BetaChave de APICLI AuthPaginação por número de página

Listar os anexos de uma tarefa

Os anexos da tarefa, ordenados por posição, em uma página. Cada url é um link de download; não o guarde. Leia o anexo de novo para obter o atual ou baixe pelo endpoint de conteúdo.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
page	integer	Opcional	Número da página, começando em 1.
page_size	integer	Opcional	Linhas por página. Padrão 50, máximo 100. Valores fora do intervalo são ajustados, nunca rejeitados: pedir 500 retorna 100.

Resposta

Nome	Tipo	Obrigatório	Descrição
count	integer	Obrigatório	Número total de linhas.
next	uri	Obrigatório	URL da próxima página, ou `null`.
previous	uri	Obrigatório	URL da página anterior, ou `null`.
results	array<TaskAttachment>	Obrigatório	As linhas desta página. Veja TaskAttachment.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task attachments ENG-142 --json

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

POST/v1/plan/tasks/{task_id}/attachments/BetaChave de APICLI Auth

Enviar um anexo em uma única requisição

Envie um arquivo em uma única requisição, até 5 MiB. Para arquivos de até 25 MiB, use presign → upload → confirm.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
file	binary	Obrigatório	O arquivo a enviar (máximo de 5 MiB por esta via).
caption	string	Opcional	Legenda opcional. Máximo de 255 caracteres.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskAttachment	Obrigatório	Um objeto TaskAttachment.

Erros

Status	Quando
400	A validação falhou, ou um valor de filtro, ordenação ou `include` não foi reconhecido. O `code` da resposta indica qual. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -F "file=@./screenshot.png" \
  -F "caption=Staging dashboard"

dailybot plan task attach ENG-142 ./screenshot.png --caption "Staging 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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

POST/v1/plan/tasks/{task_id}/attachments/presign/BetaChave de APICLI Auth

Reservar um anexo e receber um destino de upload

Reserve um anexo e obtenha um destino de upload. O size declarado pode ser de até 25 MiB quando o servidor tem armazenamento de objetos; caso contrário, os uploads são limitados a 5 MiB e declarações maiores são recusadas com attachment_too_large.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
filename	string	Obrigatório	Nome do arquivo. Máx. 255 caracteres.
content_type	string	Obrigatório	Tipo MIME. Máx. 127 caracteres.
size	integer	Obrigatório	Tamanho em bytes. De 1 a 26214400.
agent_name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa (máx. 128 caracteres, vazio significa sem agente). Tem prioridade sobre o header `X-Dailybot-Agent-Name`. Veja Atribuição de agente.

Objeto TaskAttachmentPresignResponse

Nome	Tipo	Obrigatório	Descrição
upload_url	string	Obrigatório	Para onde enviar os bytes.
method	string	Obrigatório	Método HTTP para o upload.
headers	object	Obrigatório	Headers a enviar com o upload.
expires_in	integer	Obrigatório	Segundos até o destino de upload expirar.
attachment	TaskAttachment	Obrigatório	O anexo pendente. Veja TaskAttachment.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskAttachmentPresignResponse	Obrigatório	Um objeto TaskAttachmentPresignResponse.

Erros

Status	Quando
400	A validação falhou, ou um valor de filtro, ordenação ou `include` não foi reconhecido. O `code` da resposta indica qual. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/presign/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "screenshot.png",
    "content_type": "image/png",
    "size": 482133
  }'

dailybot plan task attach ENG-142 ./screenshot.png

{
  "upload_url": "https://your.app/files/screenshot.png",
  "method": "PUT",
  "headers": {},
  "expires_in": 900,
  "attachment": {
    "uuid": "00000000-0000-4000-8000-000000000009",
    "filename": "screenshot.png",
    "content_type": "image/png",
    "size": 1,
    "url": "https://your.app/files/screenshot.png",
    "thumbnail_url": null,
    "width": null,
    "height": null,
    "status": "ready",
    "uploaded_by": {
      "kind": "user",
      "uuid": "00000000-0000-4000-8000-00000000000c",
      "name": "Ada L."
    },
    "created_at": "2026-09-25T10:14:02Z"
  }
}

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/attachments/{attachment_id}/content/BetaChave de APICLI Auth

Baixar os bytes de um anexo pela API

Transmite o arquivo, autorizado como qualquer outra leitura da tarefa. Em servidores sem armazenamento de objetos, este é o url do anexo; caso contrário, url é um link de download e este endpoint é a alternativa para clientes que preferem enviar sua credencial. 409 attachment_not_ready se o upload nunca foi concluído.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
attachment_id	string	Obrigatório	O uuid do anexo.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.
409	O upload nunca foi concluído nem confirmado (`attachment_not_ready`).

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task attachment get ENG-142 00000000-0000-4000-8000-000000000009 -o ./screenshot.png

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

PUT/v1/plan/tasks/{task_id}/attachments/{attachment_id}/content/BetaChave de APICLI Auth

Enviar os bytes de um anexo pré-assinado (alternativa local/dev)

Envie os bytes de um anexo pré-assinado quando o destino de upload aponta de volta para a API (servidores sem armazenamento de objetos). Limitado a 5 MiB.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
attachment_id	string	Obrigatório	O uuid do anexo.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskAttachment	Obrigatório	Um objeto TaskAttachment.

Erros

Status	Quando
400	A validação falhou, ou um valor de filtro, ordenação ou `include` não foi reconhecido. O `code` da resposta indica qual. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X PUT "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @./screenshot.png

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

POST/v1/plan/tasks/{task_id}/attachments/{attachment_id}/confirm/BetaChave de APICLI Auth

Marcar um anexo pré-assinado como pronto após o upload

A última etapa de pré-assinar → enviar → confirmar: marca o anexo como pronto depois que os bytes são enviados. Até lá, baixá-lo responde 409 attachment_not_ready.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
attachment_id	string	Obrigatório	O uuid do anexo.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskAttachment	Obrigatório	Um objeto TaskAttachment.

Erros

Status	Quando
400	O nome do agente não é válido (`invalid_agent_attribution`).
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/00000000-0000-4000-8000-000000000009/confirm/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task attach ENG-142 ./screenshot.png

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

DELETE/v1/plan/tasks/{task_id}/attachments/{attachment_id}/BetaChave de APICLI Auth

Remover um anexo

Remove o anexo da tarefa. O arquivo armazenado é excluído quando nada mais o referencia.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
attachment_id	string	Obrigatório	O uuid do anexo.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Erros

Status	Quando
400	O nome do agente não é válido (`invalid_agent_attribution`).
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
403	Autenticado, mas sem permissão: falta o scope (`insufficient_scope`, que é também o que uma key de agente ou da organização recebe em uma operação que exige uma pessoa, e o que uma key pessoal recebe quando seus scopes de Plan explícitos não cobrem o endpoint) ou é uma conta de convidado (`guest_not_allowed`).
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS -X DELETE "https://api.dailybot.com/v1/plan/tasks/ENG-142/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task attachment delete ENG-142 00000000-0000-4000-8000-000000000009 --yes

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/events/BetaChave de APICLI AuthPaginação por número de página

A atividade de uma tarefa, gerada a partir do registro de eventos

Os eventos trazem ids, membros de enum, números, booleanos e datas, nunca texto escrito por usuários. Não há título, descrição, corpo de comentário nem nome de etiqueta em um payload. Junte o que você tem direito de ler: os corpos dos comentários vêm do endpoint de comentários, e os títulos, da própria tarefa.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
page	integer	Opcional	Número da página, começando em 1.
page_size	integer	Opcional	Linhas por página. Padrão 50, máximo 100. Valores fora do intervalo são ajustados, nunca rejeitados: pedir 500 retorna 100.
event_type	array	Opcional	Filtrar por um ou mais tipos de evento.

Objeto TaskEvent

Nome	Tipo	Obrigatório	Descrição
uuid	string	Obrigatório	Identificador público estável.
event_type	string	Obrigatório	O tipo de evento. Novos tipos são adicionados com o tempo: ignore os que você não reconhecer.
entity	object	Opcional	—
payload	object	Opcional	Apenas ids, valores de enum, números, booleanos e datas, nunca texto escrito por usuários.
actor	object	Opcional	Quem agiu.
executed_by_agent	object \| null	Opcional	O agente que executou isto em nome da pessoa, ou `null` quando nenhum foi nomeado: um objeto com `uuid`, `name`, `username` e `avatar`. A pessoa do campo de autor continua sendo a autora; o agente é mostrado como quem executou.
origin	string	Opcional	—
correlation_id	string \| null	Opcional	—
observed_at	string	Opcional	Quando foi registrado.
occurred_at	string	Obrigatório	Quando aconteceu.

Resposta

Nome	Tipo	Obrigatório	Descrição
count	integer	Obrigatório	Número total de linhas.
next	uri	Obrigatório	URL da próxima página, ou `null`.
previous	uri	Obrigatório	URL da página anterior, ou `null`.
results	array<TaskEvent>	Obrigatório	As linhas desta página. Veja TaskEvent.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/events/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task events ENG-142 --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000f",
      "event_type": "task.moved",
      "entity": {},
      "payload": {},
      "actor": {},
      "origin": "web",
      "correlation_id": null,
      "observed_at": "example",
      "occurred_at": "example"
    }
  ]
}

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/activity/BetaChave de APICLI AuthPaginação por número de página

O feed de atividade de uma tarefa, enriquecido para exibição

Paginado, com o mesmo formato de linha de GET /v1/plan/activity/ (card da tarefa mais changes[{field, from, to}] resolvido). É isto que ?include=activity incorpora no detalhe da tarefa. Para o registro de eventos bruto, use GET …/tasks/{task_id}/events/.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
page	integer	Opcional	Número da página, começando em 1.
page_size	integer	Opcional	Linhas por página. Padrão 50, máximo 100. Valores fora do intervalo são ajustados, nunca rejeitados: pedir 500 retorna 100.

Objeto ActivityEvent

Nome	Tipo	Obrigatório	Descrição
uuid	string	Obrigatório	Identificador público estável.
type	string	Obrigatório	O tipo de evento. Novos tipos são adicionados com o tempo: ignore os que você não reconhecer.
actor	object	Obrigatório	Quem agiu.
executed_by_agent	object \| null	Opcional	O agente que executou isto em nome da pessoa, ou `null` quando nenhum foi nomeado: um objeto com `uuid`, `name`, `username` e `avatar`. A pessoa do campo de autor continua sendo a autora; o agente é mostrado como quem executou.
created_at	string	Obrigatório	Quando a linha foi criada.
task	object	Opcional	Formato: `{uuid, key, title, board {uuid, key, name} \| null} \| null`.
payload	object	Obrigatório	Apenas ids, valores de enum, números, booleanos e datas, nunca texto escrito por usuários.
changes	array	Obrigatório	Mudanças de campos resolvidas, `[{field, from, to}]`.

Resposta

Nome	Tipo	Obrigatório	Descrição
count	integer	Obrigatório	Número total de linhas.
next	uri	Obrigatório	URL da próxima página, ou `null`.
previous	uri	Obrigatório	URL da página anterior, ou `null`.
results	array<ActivityEvent>	Obrigatório	As linhas desta página. Veja ActivityEvent.

Erros

Status	Quando
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	Não encontrado ou não visível para você. Os dois casos retornam o mesmo corpo.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/activity/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task activity ENG-142 --updated-since 2026-09-20T00:00:00Z

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000f",
      "type": "task.moved",
      "actor": {},
      "created_at": "example",
      "task": {},
      "payload": {},
      "changes": []
    }
  ]
}

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/attachments/resolve/BetaChave de APICLI Auth

Resolver referências de anexos

Converte as referências de anexos que você tem (por exemplo os marcadores attachment:{uuid} de uma descrição, ou um content_url guardado) no url atual de cada anexo. Passe de 1 a 50 uuids em ids, separados por vírgulas; cobre anexos de tarefas, comentários, projetos, metas, quadros, marcos e atualizações de projeto. Um id que não existe, que você não pode ver ou cujo anexo não está ready simplesmente não aparece em resolved: os três casos parecem iguais e não há erro. Não guarde url nem a cole em lugares públicos: trate-a como opaca. url_expires_at é null ou um timestamp ISO, então peça de novo ao renderizar. Para baixar, prefira GET …/attachments/{attachment_id}/content/ com sua credencial.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
ids	string	Obrigatório	Uuids de anexos, separados por vírgulas.

Resposta

Nome	Tipo	Obrigatório	Descrição
resolved	object	Obrigatório	Um mapa de cada uuid de anexo que você pode ver para `{url, url_expires_at}`. Os ids ausentes não são listados.
resolved.{uuid}.url	string	Obrigatório	O link de download atual do anexo.
resolved.{uuid}.url_expires_at	string \| null	Obrigatório	Quando o link deixa de funcionar, como data ISO, ou `null` quando não expira.

Erros

Status	Quando
400	`ids` está vazio ou tem um uuid malformado (`invalid_filter_value`, é recusado em vez de ignorado), ou tem mais de 50 valores (`too_many_filter_values`).
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].

curl -sS "https://api.dailybot.com/v1/plan/attachments/resolve/?ids=00000000-0000-4000-8000-000000000009,00000000-0000-4000-8000-000000000010" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks attachments-resolve 00000000-0000-4000-8000-000000000009

{
  "resolved": {
    "00000000-0000-4000-8000-000000000009": {
      "url": "/v1/plan/tasks/00000000-0000-4000-8000-000000000003/attachments/00000000-0000-4000-8000-000000000009/content/",
      "url_expires_at": null
    }
  }
}

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

PATCH/v1/plan/tasks/{task_id}/comments/{comment_id}/attachments/{attachment_id}/BetaChave de APICLI Auth

Renomear um anexo do comentário

Muda o nome de exibição do arquivo; os bytes guardados não mudam. Qualquer pessoa que possa escrever no item pai pode renomear seus anexos.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.
attachment_id	uuid	Obrigatório	O uuid do anexo.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Dailybot-Agent-Name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa. Use-o em escritas multipart e sem corpo (DELETE, arquivar, restaurar); em escritas JSON envie o campo `agent_name` do corpo, que vence se os dois vierem. Codifique o valor em percent-encoding (UTF-8). Caracteres de controle são removidos; um valor em branco significa sem agente. Mais de 128 caracteres, ou um valor que não pode ser decodificado, é `400 invalid_agent_attribution` (nunca é truncado). Uma chave do tipo agente, que não está ligada a uma pessoa, recebe `400 invalid_agent_attribution` se enviá-lo. O selo nunca altera uma resposta de permissão. Veja Atribuição de agente.

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
filename	string	Obrigatório	O novo nome do arquivo (1–255 caracteres). Os bytes guardados não mudam.
agent_name	string	Opcional	O nome do agente que executou esta escrita em nome da pessoa (máx. 128 caracteres, vazio significa sem agente). Tem prioridade sobre o header `X-Dailybot-Agent-Name`. Veja Atribuição de agente.

Resposta

Nome	Tipo	Obrigatório	Descrição
(body)	TaskAttachment	Obrigatório	Um objeto TaskAttachment.

Erros

Status	Quando
400	A validação falhou; o `code` da resposta indica qual campo. `invalid_agent_attribution` significa que o nome do agente não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
403	Você não pode escrever aqui (`insufficient_scope`), ou é convidado (`guest_not_allowed`).
404	O item pai ou o anexo não existe ou você não pode vê-lo (`not_found`), nunca um 403.

curl -sS -X PATCH "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "filename": "spec-v2.pdf"
}'

dailybot plan task comment attachments rename ENG-142 00000000-0000-4000-8000-000000000008 00000000-0000-4000-8000-000000000009 spec-v2.pdf

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.

Scope: `tasks:write`.
Limite de requisições: 60 escritas por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

GET/v1/plan/tasks/{task_id}/comments/{comment_id}/reactions/BetaChave de APICLI AuthPaginação por número de página

Listar quem reagiu a um comentário

Todos os que reagiram, do mais antigo ao mais recente, como uma página: a lista completa por trás da prévia limitada users de cada reação do comentário. emoji restringe a um único emoji.

Parâmetros de rota

Nome	Tipo	Obrigatório	Descrição
task_id	string	Obrigatório	Um uuid de tarefa ou sua chave, como `ENG-142`, incluindo uma chave retirada por uma renomeação de quadro. A resolução tem escopo primeiro na sua organização, então a chave de outra organização é um 404 idêntico ao de uma inexistente. Ids numéricos nunca são aceitos.
comment_id	string	Obrigatório	O uuid do comentário.

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
page	integer	Opcional	Número da página, começando em 1.
page_size	integer	Opcional	Linhas por página. Padrão 50, máximo 100. Valores fora do intervalo são ajustados, nunca rejeitados: pedir 500 retorna 100.
emoji	string	Opcional	Um emoji; todos os emojis quando omitido. A mesma regra das escritas: qualquer outra coisa é `400 reaction_invalid_emoji`.

Objeto Reactor

Nome	Tipo	Obrigatório	Descrição
emoji	string	Obrigatório	—
user	ActorRef	Obrigatório	Quem reagiu.
executed_by_agent	AgentRef \| null	Opcional	O agente que executou a reação por essa pessoa, ou `null`.
created_at	datetime	Obrigatório	—

Objeto ActorRef

Nome	Tipo	Obrigatório	Descrição
kind	string	Obrigatório	—
uuid	string	Obrigatório	Identificador público estável.
name	string	Opcional	Nome de exibição.
username	string \| null	Opcional	—
avatar_url	string \| null	Opcional	—
has_photo	boolean	Opcional	—

Resposta

Nome	Tipo	Obrigatório	Descrição
count	integer	Obrigatório	Número total de linhas.
next	uri	Obrigatório	URL da próxima página, ou `null`.
previous	uri	Obrigatório	URL da página anterior, ou `null`.
results	array<Reactor>	Obrigatório	A página de objetos Reactor.

Erros

Status	Quando
400	`emoji` não é um único emoji (`reaction_invalid_emoji`), ou um valor de paginação não é válido.
401	Credencial ausente, expirada ou malformada (`credential_absent`, `credential_expired`, `credential_malformed`).
402	O Plan ainda não está habilitado para sua organização (`plan_upgrade_required`). É o esperado durante a Beta: escreva para [email protected].
404	A tarefa ou o comentário não existe ou você não pode vê-lo (`not_found`), nunca um 403.

curl -sS "https://api.dailybot.com/v1/plan/tasks/ENG-142/comments/00000000-0000-4000-8000-000000000008/reactions/?emoji=%F0%9F%91%8D" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task comment-reactions ENG-142 00000000-0000-4000-8000-000000000008

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "emoji": "👍",
      "user": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-000000000001",
        "name": "Ana"
      },
      "executed_by_agent": null,
      "created_at": "2026-09-30T14:00:00Z"
    }
  ]
}

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.

Scope: `tasks:read`.
Limite de requisições: 120 leituras por minuto por ator.
Funciona com uma sessão iniciada, um token de usuário da CLI, uma API key pessoal, ou uma key de agente ou da organização. Uma key pessoal vê o que sua pessoa vê; uma key de agente ou da organização atua como um ator de sistema e vê apenas quadros visíveis para a organização.

Esta página é a referência de Plan · Comentários e arquivos. Todos os endpoints ficam em https://api.dailybot.com/v1/plan/ e respondem JSON.

Autentique com uma sessão iniciada ou um token de usuário da CLI (Authorization: Bearer …), ou com uma API key (X-API-KEY). Uma API key pessoal age como sua pessoa e pode fazer tudo o que essa pessoa pode fazer no Dailybot; uma key de agente ou da organização nunca age como uma pessoa e é recusada nos endpoints que exigem uma. Em um endpoint, o selo API key significa que uma key de agente ou da organização também é aceita. Veja Autenticação do Plan, Autenticação e Erros para as regras comuns a todas as APIs do Dailybot.

Se é sua primeira vez com o Plan, leia a visão geral para entender o modelo: projetos, quadros, estados, chaves, ordem, versões e arquivamento.