Plan · Quadros

Listar quadros

Os quadros que você pode ver, em uma página. Filtre por project, busque com search, por datas com start_date / end_date e traga os quadros arquivados com include_archived. Uma key de agente ou da organização só vê os quadros visíveis para a organização; uma key pessoal vê o que sua pessoa vê.

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

dailybot plan board list --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000002",
      "key": "ENG",
      "name": "Engineering",
      "project": {
        "uuid": "00000000-0000-4000-8000-000000000001",
        "name": "Platform",
        "is_archived": false
      },
      "team": null,
      "visibility": "org",
      "estimate_scale": "fibonacci",
      "default_view": null,
      "archive_after_days": null,
      "task_count": 12,
      "wip_limits": {},
      "is_archived": false,
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z",
      "viewer": {},
      "states": []
    }
  ]
}

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

Obter um quadro

Um quadro pelo uuid. Um quadro que você não pode ver responde 404, igual a um que não existe.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board get 00000000-0000-4000-8000-000000000002

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

Listar os estados de um quadro, na ordem das colunas

Os estados do fluxo de trabalho do quadro (suas colunas), ordenados por posição. Cada um tem uma category (como in_progress) que se mantém quando o estado é renomeado. Adicione include_archived=true para ver os estados arquivados.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/states/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board states 00000000-0000-4000-8000-000000000002 --include-archived

[
  {
    "uuid": "00000000-0000-4000-8000-000000000003",
    "name": "In Progress",
    "category": "in_progress",
    "position": 2,
    "color": "#2563eb",
    "is_default": false,
    "is_archived": false,
    "task_count": 12
  }
]

• 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 quadro inteiro — estados e suas tarefas — em uma única ida e volta

Uma chamada renderiza um quadro: uma entrada em groups por coluna, na ordem das colunas, cada uma com suas primeiras tarefas em ordem de rank, o task_count real da coluna e has_more. Pagine o restante de uma coluna com GET /v1/plan/tasks/?board=…&state=….

Guarde delta_cursor e passe a usar o feed de mudanças em todas as leituras seguintes. Responde a If-None-Match com 304. …/snapshot/ é um alias com a mesma resposta. Parâmetros de consulta desconhecidos e valores de filtro inválidos resultam em 400 invalid_filter_value.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/board/?tasks_per_state=25" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board snapshot 00000000-0000-4000-8000-000000000002 --json

{
  "board": {
    "uuid": "00000000-0000-4000-8000-000000000100",
    "key": "ENG",
    "name": "Engineering",
    "visibility": "org",
    "estimate_scale": "fibonacci",
    "project": {
      "uuid": "00000000-0000-4000-8000-000000000101",
      "name": "Platform"
    }
  },
  "generated_at": "2026-08-29T10:14:02.113954Z",
  "delta_cursor": "2026-08-29T10:14:02.113954Z",
  "group_by": "state",
  "groups": [
    {
      "key": "00000000-0000-4000-8000-000000000102",
      "name": "In Progress",
      "category": "in_progress",
      "position": 2,
      "color": "#f59e0b",
      "task_count": 137,
      "has_more": true,
      "tasks": [
        {
          "uuid": "00000000-0000-4000-8000-000000000103",
          "key": "ENG-142",
          "title": "Ship the delta feed",
          "state": {
            "uuid": "00000000-0000-4000-8000-000000000102",
            "name": "In Progress",
            "category": "in_progress"
          },
          "priority": 2,
          "estimate": 3,
          "rank": "aU",
          "version": 7,
          "open_blocker_count": 1,
          "participant_count": 3,
          "owner": {
            "uuid": "00000000-0000-4000-8000-000000000104",
            "name": "Ada L."
          },
          "executor": null,
          "due_date": "2026-09-04",
          "labels": [
            {
              "uuid": "00000000-0000-4000-8000-000000000105",
              "name": "backend",
              "color": "#2563eb"
            }
          ],
          "is_archived": false,
          "updated_at": "2026-08-29T10:12:44.201113Z"
        }
      ]
    }
  ]
}

• 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 que mudou neste quadro desde um timestamp. NÃO é paginação

Um feed de mudanças, não uma página: sem count, next ou previous. Envie o cursor da sua resposta anterior (ou o delta_cursor do snapshot) literalmente como updated_since; nunca o calcule a partir do seu próprio relógio.

A entrega é pelo menos uma vez, então uma linha gravada no mesmo instante do seu cursor é enviada de novo em vez de se perder. As entradas são compactadas em uma por tarefa (a linha atual prevalece). states é null a menos que uma coluna tenha sido criada, renomeada, reordenada ou arquivada; quando vier preenchido, substitua toda a sua lista de colunas.

Consulte de novo após poll_after_seconds (15 s, dobrando até 120 s enquanto o quadro está parado, reiniciando a cada mudança). Pause enquanto a página estiver oculta e atualize quando ela voltar a ficar visível. Se truncated for true, consulte de novo imediatamente. Cursores com mais de 7 dias retornam 400 delta_window_expired: leia o snapshot de novo. Polling é o transporte da v1.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/delta/?updated_since=2026-09-25T10:14:02.113954Z" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan tasks changes 00000000-0000-4000-8000-000000000002 --updated-since 2026-09-25T10:14:02.113954Z --json

{
  "since": "2026-08-29T10:14:02.113954Z",
  "cursor": "2026-08-29T10:19:44.902311Z",
  "changed": [
    {
      "uuid": "00000000-0000-4000-8000-000000000100",
      "key": "ENG-142",
      "title": "Ship the delta feed",
      "state": {
        "uuid": "00000000-0000-4000-8000-000000000101",
        "name": "Done",
        "category": "done"
      },
      "priority": 2,
      "rank": "b0",
      "version": 9,
      "is_archived": false,
      "updated_at": "2026-08-29T10:19:44.902311Z"
    }
  ],
  "removed": [
    {
      "uuid": "00000000-0000-4000-8000-000000000102",
      "key": "ENG-77",
      "reason": "archived"
    }
  ],
  "states": null,
  "truncated": false,
  "poll_after_seconds": 15
}

• Scope: `tasks:read`.
• Limite de requisições: 240 consultas ao feed de mudanças 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.

As visualizações salvas de quem chama para este quadro

Suas visualizações salvas para este quadro. As visualizações são pessoais. 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/boards/00000000-0000-4000-8000-000000000002/views/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan board views 00000000-0000-4000-8000-000000000002 --etag

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "name": "My open work",
      "view_mode": "list",
      "group_by": "state",
      "sort": "-updated_at",
      "filters": {},
      "schema_version": 1,
      "visibility": "personal",
      "collapsed": {},
      "columns": {}
    }
  ]
}

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

Pesquisar pessoas que podem ser mencionadas em um quadro

A lista para os seletores de responsável e participantes, com busca por q (nome, handle ou id externo, nunca um endereço de e-mail completo). Não use a lista de membros para os seletores: ela só mostra permissões explícitas e costuma estar vazia em quadros visíveis para toda a organização.

Pessoas que não podem ver o quadro nunca aparecem, mesmo quando correspondem a q, assim como a regra que as recusa como responsáveis ou participantes (participant_cannot_access_board). limit (25 por padrão) e offset percorrem toda a lista em uma ordem estável.

As linhas são {uuid, name, handle, avatar_url, has_photo, kind}, sem e-mail. avatar_url e has_photo significam o mesmo que no responsável de uma tarefa: quando has_photo é false, mostre as iniciais; em uma linha agent eles são null e false. Identifique os chips de menção pelo uuid, nunca pelo handle: o handle não é único dentro de uma organização, então mostre name para diferenciar. kinds=agent lista os agentes do espaço de trabalho, mas ainda não é possível mencionar um agente; não monte uma menção a partir de uma linha agent.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/mentionables/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan board mentionables 00000000-0000-4000-8000-000000000002 -q ada

{
  "limit": 25,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000c",
      "name": "Ada L.",
      "handle": "ada",
      "avatar_url": "https://example.com/avatars/ada.png",
      "has_photo": true,
      "kind": "user"
    },
    {
      "uuid": "00000000-0000-4000-8000-000000000012",
      "name": "Grace H.",
      "handle": null,
      "avatar_url": null,
      "has_photo": false,
      "kind": "user"
    }
  ]
}

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

Membros de um quadro

Somente concessões explícitas de associação, nunca a lista completa da organização, por isso quadros visíveis para a organização muitas vezes retornam uma lista vazia. Use-a para gerenciar quem pode ver um quadro somente para membros; para seletores, use …/mentionables/. Um administrador da organização pode ler esta lista sem passar a ver as tarefas do quadro.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/members/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan board members 00000000-0000-4000-8000-000000000002

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "subject_type": "user",
      "user_uuid": "00000000-0000-4000-8000-00000000000c",
      "uuid": "00000000-0000-4000-8000-00000000000c",
      "full_name": "Ada L.",
      "name": "Ada L.",
      "role": "admin",
      "team_uuid": null,
      "team_name": "example",
      "added_at": "2026-09-25T10:14:02Z",
      "added_by_uuid": null
    }
  ]
}

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

Listar etiquetas da organização (verificação de acesso ao quadro)

As etiquetas da organização, por trás da verificação de acesso deste quadro, para que as configurações do quadro possam gerenciá-las sem sair da API do Plan. Aplique etiquetas aos cards com o PATCH da tarefa, o endpoint de etiquetas em lote ou o set_labels em massa.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/labels/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan board labels 00000000-0000-4000-8000-000000000002

{
  "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`.

Uma visualização salva por uuid

Pode ser lida quando é a sua própria visualização, ou uma visualização shared ou board_default de um quadro que você pode ver. Qualquer outra, inclusive a visualização pessoal de outra pessoa, é 404, nunca 403.

curl -sS "https://api.dailybot.com/v1/plan/views/{view_id}/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan tasks view get 00000000-0000-4000-8000-000000000010 --json

• 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 os anexos do quadro

Os anexos prontos do quadro, ordenados por posição, como uma página. Qualquer pessoa que possa ver o quadro pode listá-los; um quadro que você não pode ver é 404. Cada url é um link de download: não o guarde, mantenha o uuid do anexo e leia de novo quando precisar do arquivo.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000009",
      "filename": "roadmap.pdf",
      "content_type": "application/pdf",
      "size": 48213,
      "url": "https://media.dailybot.com/\u2026",
      "url_expires_at": null,
      "content_url": "/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/00000000-0000-4000-8000-000000000009/content/",
      "thumbnail_url": null,
      "width": null,
      "height": null,
      "status": "ready",
      "uploaded_by": {
        "kind": "user",
        "uuid": "00000000-0000-4000-8000-000000000001",
        "name": "Ana"
      },
      "created_at": "2026-09-30T14:00:00Z"
    }
  ]
}

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

Obter um anexo do quadro

Um anexo do quadro. Qualquer pessoa que possa ver o quadro pode lê-lo.

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

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

Baixar os bytes de um anexo do quadro

Os bytes do arquivo, com o tipo de conteúdo registrado, pela API em vez do link de mídia. Um anexo cujo envio ainda não terminou é 409 attachment_not_ready.

curl -sS "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -o roadmap.pdf

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