Plan · Projetos

Listar projetos

Os projetos que você pode ver, em uma página. Busque com search, filtre por datas com start_date / end_date e traga os projetos arquivados com include_archived. include adiciona blocos opcionais a cada linha.

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

dailybot plan project list --include progress --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000001",
      "name": "Platform",
      "slug": "platform",
      "description": null,
      "lead": {
        "uuid": "00000000-0000-4000-8000-00000000000c",
        "name": "Ada L."
      },
      "goals": [],
      "goal": {},
      "board_count": 1,
      "health": "on_track",
      "start_date": "2026-09-28",
      "target_date": "2026-10-15",
      "progress": {
        "total": 10,
        "completed": 4,
        "percent_complete": 40
      },
      "is_archived": false,
      "archived_at": null,
      "created_at": "2026-09-25T10:14:02Z",
      "updated_at": "2026-09-25T10:14:02Z",
      "viewer": {}
    }
  ]
}

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

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

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

dailybot plan project get 00000000-0000-4000-8000-000000000001 --include progress

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

As atualizações mais recentes de todos os projetos que quem chama pode ver

A forma em lote da lista de atualizações por projeto, para uma tela inicial que, de outro modo, a chamaria uma vez por projeto.

Retorna as per_project atualizações mais recentes de cada projeto visível como uma única lista plana e paginada; cada linha traz seu project, então agrupe por esse campo. Ordenada pelo nome do projeto e depois da mais recente para a mais antiga. É uma prévia, não um histórico: para uma thread completa ou um projeto arquivado, use GET /v1/plan/projects/{project_id}/updates/.

projects restringe aos projetos indicados. Um projeto que você não pode ver é omitido silenciosamente em vez de recusado, e projetos arquivados são excluídos mesmo quando indicados. body_html é renderizado e sanitizado no servidor.

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

dailybot plan project updates --json

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000e",
      "project": "00000000-0000-4000-8000-000000000001",
      "body": "Staging is green; rolling out Friday.",
      "body_html": "<p>Staging is green; rolling out Friday.</p>",
      "mentions": [],
      "health": "on_track",
      "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.
• 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.

Notas de status de um projeto, das mais recentes para as mais antigas

A metade narrativa de um roadmap: por que a saúde está como está, com um nome e uma data. body é o Markdown como foi digitado; body_html é renderizado no servidor pelo mesmo sanitizador que os comentários usam, então nenhum HTML enviado pelo cliente é confiável.

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

dailybot plan project updates 00000000-0000-4000-8000-000000000001 --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.

Compromissos com data dentro de um projeto, em ordem de data

Cada linha traz task_count, anotado na mesma consulta: um roadmap desenha todos os marcadores de uma vez, então uma contagem por marcador seria uma consulta por linha.

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

dailybot plan project milestones 00000000-0000-4000-8000-000000000001

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000007",
      "name": "Beta launch",
      "description": null,
      "date": "2026-09-28",
      "task_count": 12,
      "is_archived": false,
      "completed_at": null,
      "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.
• 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.

Todos os marcos que quem visualiza pode ver, entre projetos

Todos os marcos que você pode ver entre projetos, em uma única chamada, para os marcadores de um roadmap. A visibilidade segue os projetos que você pode abrir. project__in restringe esse conjunto e nunca o amplia: um uuid desconhecido e o uuid de outra organização retornam um resultado vazio. As linhas trazem project como referência.

curl -sS "https://api.dailybot.com/v1/plan/milestones/?project__in=00000000-0000-4000-8000-000000000001" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan project milestones

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "00000000-0000-4000-8000-000000000007",
      "name": "Beta launch",
      "description": null,
      "date": "example",
      "task_count": 12,
      "is_archived": false,
      "project": {},
      "created_at": "example",
      "updated_at": "example"
    }
  ]
}

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

As visualizações salvas desta pessoa dentro de um projeto

Suas visualizações salvas dentro de um projeto: conjuntos de filtros nomeados que abrangem todos os quadros dele. As visualizações são pessoais e têm escopo por projeto, então o mesmo nome pode existir em dois projetos. 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/projects/00000000-0000-4000-8000-000000000001/views/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan project views 00000000-0000-4000-8000-000000000001 --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`.

Membros de um projeto

Visível para qualquer pessoa que possa ver o projeto. Em um projeto members, esta é a associação que dá acesso ao projeto e aos seus quadros.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/members/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan project members 00000000-0000-4000-8000-000000000001

{
  "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.
• 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 de um projeto

Os anexos do projeto, ordenados por posição. Qualquer pessoa que possa ver o projeto pode listar os anexos; um projeto 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. Para mostrar uma imagem na descrição do projeto, referencie-a como attachment:{uuid} e resolva-a ao renderizar com o url recente desta lista.

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

dailybot plan project attachments 00000000-0000-4000-8000-000000000001 --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"
    }
  ]
}

• 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 de um projeto

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. Qualquer pessoa que possa ver o projeto pode baixá-lo.

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

dailybot plan project attachment get 00000000-0000-4000-8000-000000000001 00000000-0000-4000-8000-000000000009 -o ./plan.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.

Listar os anexos do marco

Os anexos prontos do marco, ordenados por posição. Qualquer pessoa que possa ver o projeto pode listá-los; um projeto 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. Referencie-o na description do marco com um marcador attachment:{uuid} e resolva-o com GET /v1/plan/attachments/resolve/ ao renderizar.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/milestones/00000000-0000-4000-8000-000000000007/attachments/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

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

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

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

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/milestones/00000000-0000-4000-8000-000000000007/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "uuid": "00000000-0000-4000-8000-000000000009",
  "filename": "roadmap.png",
  "content_type": "image/png",
  "size": 48213,
  "url": "https://your.app/files/roadmap.png",
  "thumbnail_url": null,
  "width": null,
  "height": null,
  "status": "ready",
  "uploaded_by": {
    "kind": "user",
    "uuid": "00000000-0000-4000-8000-00000000000c",
    "name": "Ada L."
  },
  "executed_by_agent": null,
  "created_at": "2026-09-29T10:14:02Z"
}

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

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. Qualquer pessoa que possa ver o projeto pode baixá-lo.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/milestones/00000000-0000-4000-8000-000000000007/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" -o roadmap.png

• 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 uma atualização de projeto

Uma nota de status, com seus attachments prontos incluídos, provenance, edited_at (nulo até a primeira edição) e executed_by_agent.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "uuid": "00000000-0000-4000-8000-00000000000a",
  "project": "00000000-0000-4000-8000-000000000001",
  "body": "Staging is green; rolling out Friday.",
  "body_html": "<p>Staging is green; rolling out Friday.</p>",
  "mentions": [],
  "health": "on_track",
  "created_by": {
    "kind": "user",
    "uuid": "00000000-0000-4000-8000-00000000000c",
    "name": "Ada L."
  },
  "executed_by_agent": null,
  "provenance": "typed",
  "edited_at": null,
  "attachments": [],
  "created_at": "2026-09-29T10:14:02Z",
  "updated_at": "2026-09-29T10:14:02Z"
}

• 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 anexos da atualização

Os anexos prontos da atualização, ordenados por posição. Qualquer pessoa que possa ver o projeto pode listá-los; um projeto 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. Referencie-o na body da atualização com um marcador attachment:{uuid} e resolva-o com GET /v1/plan/attachments/resolve/ ao renderizar.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/attachments/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

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

• 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 da atualização

Um anexo da atualização. Qualquer pessoa que possa ver o projeto pode lê-lo.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/attachments/00000000-0000-4000-8000-000000000009/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

{
  "uuid": "00000000-0000-4000-8000-000000000009",
  "filename": "roadmap.png",
  "content_type": "image/png",
  "size": 48213,
  "url": "https://your.app/files/roadmap.png",
  "thumbnail_url": null,
  "width": null,
  "height": null,
  "status": "ready",
  "uploaded_by": {
    "kind": "user",
    "uuid": "00000000-0000-4000-8000-00000000000c",
    "name": "Ada L."
  },
  "executed_by_agent": null,
  "created_at": "2026-09-29T10:14:02Z"
}

• 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 da atualização

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. Qualquer pessoa que possa ver o projeto pode baixá-lo.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000001/updates/00000000-0000-4000-8000-00000000000a/attachments/00000000-0000-4000-8000-000000000009/content/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" -o roadmap.png

• 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 quem reagiu a uma atualização do projeto

Todos os que reagiram à atualização, do mais antigo ao mais recente, como uma página. emoji restringe a um único emoji. O mesmo formato da lista de reações de um comentário.

curl -sS "https://api.dailybot.com/v1/plan/projects/00000000-0000-4000-8000-000000000003/updates/00000000-0000-4000-8000-000000000007/reactions/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan project update reactions 00000000-0000-4000-8000-000000000003 00000000-0000-4000-8000-000000000007

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