Plan · Início e busca

As tarefas do usuário que faz a chamada

Suas tarefas, o mesmo que GET /v1/plan/tasks/?owner=me mais a escolha de scope. Exige uma pessoa: uma key de agente ou da organização recebe 403 insufficient_scope, nunca uma lista vazia; uma API key pessoal funciona.

curl -sS "https://api.dailybot.com/v1/plan/me/tasks/?scope=involved&state=open" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks mine --scope involved --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000005",
      "key": "ENG-142",
      "title": "Ship the delta feed",
      "description": null,
      "board": "00000000-0000-4000-8000-000000000002",
      "state": {
        "uuid": "00000000-0000-4000-8000-000000000003",
        "name": "In Progress",
        "category": "in_progress",
        "position": 2
      },
      "priority": 2,
      "estimate": 3,
      "owner": {
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "executor": null,
      "participant_count": 1,
      "start_date": "2026-09-28",
      "due_date": "2026-10-15",
      "milestone": null,
      "parent_task": null,
      "subtask_count": 1,
      "subtask_done_count": 1,
      "attachment_count": 1,
      "open_blocker_count": 1,
      "labels": [],
      "rank": "aU",
      "blocked": false,
      "blocked_since": null,
      "completed_at": null,
      "is_archived": false,
      "subscribed": true,
      "version": 7,
      "created_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z"
    }
  ]
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Contagens das abas de tarefas pessoais

Contagens com escopo de quem chama para trabalho do qual é responsável, em que participa, em que está envolvido e atrasado. Os quatro inteiros de nível superior são totais da população em todo o ciclo de vida: owned conta todas as tarefas das quais quem chama é responsável, estejam abertas, concluídas ou canceladas. overdue é a exceção e é somente owned, já excluindo trabalho arquivado e terminal. by_scope traz os números qualificados por status, para que um badge possa dizer "N abertas" sem uma segunda requisição. open é decidido pela CATEGORIA do estado, exatamente como ?state=open decide; overdue significa aberta E com prazo vencido; blocked usa o único predicado de bloqueador ativo. Todos os números são calculados no mesmo agregado único sobre a mesma raiz de visibilidade. by_scope.<scope>.total é igual, por construção, ao inteiro de nível superior de mesmo nome.

curl -sS "https://api.dailybot.com/v1/plan/me/tasks/counts/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks counts

{
  "owned": 1,
  "participating": 1,
  "involved": 1,
  "overdue": 1,
  "by_scope": {}
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Quadros visitados recentemente por quem chama

Quadros que você abriu recentemente, dos mais recentes para os mais antigos, conforme registrado por POST /v1/plan/boards/{board_id}/visit/. Quadros ocultos, arquivados e de outras organizações são omitidos em vez de gerar erro. Exige uma pessoa (uma key de agente ou da organização recebe 403; uma API key pessoal funciona).

curl -sS "https://api.dailybot.com/v1/plan/me/recents/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "count": 1,
  "limit": 1,
  "results": []
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Eventos de tarefas relevantes para notificação de quem chama

A sua caixa de entrada: eventos de tarefas que merecem a sua atenção, do mais recente ao mais antigo, em uma página. mentioned=true mantém só os eventos em que alguém mencionou você; type mantém um tipo de evento. Os dois se combinam, e count e a paginação são exatos, então não há páginas vazias.

curl -sS "https://api.dailybot.com/v1/plan/inbox/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks inbox --json

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

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Contagem de não lidos da caixa de entrada de quem chama

Quantos itens da caixa de entrada você ainda não leu, para um selo. Aceita os mesmos filtros da lista da caixa, então o selo de cada aba conta exatamente as linhas dela: mentioned=true para Menções, type=task.owner_changed para Atribuídas. Sem parâmetros conta a caixa inteira. Mais barato do que listar a caixa.

curl -sS "https://api.dailybot.com/v1/plan/inbox/unread-count/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks inbox-unread

{
  "unread_count": 3
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Feed de atividade da organização para o Plan Home

Eventos paginados que você pode abrir, enriquecidos com cartões de tarefa e changes[{field, from, to}] resolvidos para exibição. Tarefas que você não pode ver são omitidas mesmo quando o quadro é visível.

Só os parâmetros listados aqui são aceitos: qualquer outro parâmetro de consulta é 400 invalid_filter_value.

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

dailybot plan tasks activity --last-week --json
dailybot plan tasks activity --board 00000000-0000-4000-8000-000000000002 --since 2026-09-20T00:00:00Z --json

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

Ler o cursor de leitura de atividade de quem chama

O seu cursor de leitura de atividade: o momento até o qual você leu o feed de atividade. É null até você defini-lo.

curl -sS "https://api.dailybot.com/v1/plan/me/activity-cursor/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks cursor

{
  "last_seen_at": null
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Listar etiquetas da organização

A taxonomia de etiquetas da organização, compartilhada com formulários e check-ins. Prefira este endpoint para telas de configuração; a lista com escopo de quadro é a mesma taxonomia por trás de uma verificação de acesso ao quadro.

curl -sS "https://api.dailybot.com/v1/plan/labels/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000b",
      "name": "backend",
      "color": "#2563eb"
    }
  ]
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.

Se Plan está disponível aqui, e os tetos do plano

Se Plan está disponível para a sua organização, e os tetos do plano. É o único endpoint de Plan que nunca responde 402, então chame-o antes de decidir se deve mostrar o produto.

enabled é a mesma verificação que todos os outros endpoints aplicam. reason é null quando habilitado; caso contrário, rollout (sua organização ainda não foi habilitada para a Beta) ou usage (um admin desativou Plan). boards e projects informam {used, limit}, mesmo quando desabilitado; limit é null quando o plano não tem teto. O plano gratuito inclui até 3 quadros e 1 projeto. used conta apenas linhas ativas, então arquivar libera uma vaga, e used > limit pode acontecer em planos legados.

Um convidado recebe 403 guest_not_allowed aqui, não 200 com enabled: false, e nunca vê os tetos do plano.

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

dailybot plan tasks entitlements

{
  "enabled": false,
  "reason": null,
  "boards": {},
  "projects": {},
  "labels": {}
}

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

O trabalho agendado em uma janela, com suas arestas de dependência e faixas de metas

O mesmo conjunto filtrado da lista de tarefas, com uma pergunta de agendamento. rows são os cards que SE SOBREPÕEM à janela; unscheduled conta os cards correspondentes sem nenhuma data; dependencies traz apenas arestas cujas duas pontas estão em rows, porque uma seta para uma linha que o leitor não pode ver é uma linha para lugar nenhum na tela e uma revelação fora dela. Seleção da janela (vale a primeira correspondência): - from + to (datas ISO) — intervalo explícito; from pode estar no passado (ex.: hoje−7 … hoje+21). Aliases: window_from / window_to. - window_days — auxiliar para frente: de hoje até hoje+N (intervalo inclusivo). - omitido — janela padrão para frente de 14 dias a partir de hoje (com um filtro de quadro).

curl -sS "https://api.dailybot.com/v1/plan/timeline/?board=ENG&from=2026-09-18&to=2026-10-16" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan tasks timeline --today

{
  "window": {},
  "bands": [],
  "rows": [],
  "dependencies": [],
  "unscheduled": 1,
  "truncated": false
}

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

Pesquisar tarefas e contêineres visíveis para quem chama

Pesquise tarefas (título, chave, descrição) e, com types, projetos, quadros e metas que você pode ver.

A correspondência é uma busca de substring sem diferenciar maiúsculas e minúsculas, não um ranking de texto completo. score é um auxílio de ordenação aproximado entre 0.6 e 1.0 (chave exata 1.0, acerto no título ou nome 0.9 / 0.85, acerto na descrição 0.6), não uma relevância calibrada, e snippet é uma janela em torno da primeira correspondência. A resposta repete isso em approximation. Tarefas ocultas e quadros privados nunca aparecem.

curl -sS "https://api.dailybot.com/v1/plan/search/?q=delta&types=task,board" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan tasks search -q "delta" --json

{
  "q": "delta",
  "limit": 1,
  "approximation": "substring",
  "results": []
}

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

A tela inicial em uma requisição (HomePulse) ou um agregado de saúde do quadro (TaskPulse)

Dois modos, escolhidos pela presença de group_by.

HomePulse (sem group_by): a página inicial do Plan em uma requisição: generated_at, counts inteiros, o seu my_preview, prévias de quadros, metas e linha do tempo, agent_summary e as faixas opcionais de include. A população é declarada como scope: "viewer_visible": todas as tarefas ativas e não terminais que você pode ver, não a organização inteira. Cada bloco indica a consulta que o reproduz: open → ?state=open, overdue → ?due_before=<today>&state=open, blocked → ?blocked=true&state=open.

TaskPulse (com group_by, por exemplo group_by=state): um agregado de saúde do quadro com totais, throughput e tempo de ciclo. As contagens são apenas inteiros e não há detalhamento por pessoa. Responde a If-None-Match com 304.

curl -sS "https://api.dailybot.com/v1/plan/pulse/?include=projects,attention,activity,goal_progress" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan tasks status --json

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

Seus quadros e visualizações salvas fixados

Todos os seus pins, na ordem de rank (1 é o primeiro). Um pin cujo destino você não pode mais ver (um quadro arquivado ou oculto, ou uma visualização salva que não existe mais ou deixou de ser compartilhada) é omitido em vez de gerar erro. A lista usa o envelope de lista padrão, mas nunca é paginada: next e previous são sempre null, e ela tem até 50 pins. Exige uma pessoa: keys de agente e da organização são recusadas; uma API key pessoal funciona.

curl -sS "https://api.dailybot.com/v1/plan/me/favorites/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks favorites --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000012",
      "target_type": "board",
      "target_uuid": "00000000-0000-4000-8000-000000000012",
      "rank": "aU",
      "created_at": "2026-09-25T10:14:02Z"
    }
  ]
}

• Scope: `tasks:read`.
• Limite de requisições: 120 leituras por minuto por ator.
• Exige uma pessoa: chame com uma sessão iniciada, um token de usuário da CLI ou uma API key pessoal. Uma key de agente ou da organização recebe `403 insufficient_scope`.