Plan · Proyectos

Listar proyectos

Los proyectos que puedes ver, en una página. Busca con search, filtra por fechas con start_date / end_date y trae los proyectos archivados con include_archived. include agrega bloques opcionales a cada fila.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Obtener un proyecto

Un proyecto por su uuid. Un proyecto que no puedes ver responde 404, igual que uno que no 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Las actualizaciones más recientes de todos los proyectos que quien llama puede ver

La forma agrupada de la lista de actualizaciones por proyecto, para una pantalla de inicio que de otro modo la llamaría una vez por proyecto.

Devuelve las per_project actualizaciones más recientes de cada proyecto visible como una sola lista plana y paginada; cada fila lleva su project, así que agrupa por ese campo. Ordenada por nombre de proyecto y luego de la más reciente a la más antigua. Es un avance, no un historial: para un hilo completo o un proyecto archivado, usa GET /v1/plan/projects/{project_id}/updates/.

projects limita a los proyectos indicados. Un proyecto que no puedes ver se omite en silencio en lugar de rechazarse, y los proyectos archivados se excluyen aunque se indiquen. body_html se genera y se sanitiza en el 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Notas de estado de un proyecto, las más recientes primero

La mitad narrativa de un roadmap: por qué la salud es la que es, con un nombre y una fecha. body es el Markdown tal como se escribió; body_html se genera en el servidor con el mismo sanitizador que usan los comentarios, así que nunca se confía en HTML enviado por el cliente.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Compromisos con fecha dentro de un proyecto, en orden de fecha

Cada fila incluye task_count, calculado en la misma consulta: un roadmap dibuja todos los marcadores a la vez, así que un conteo por marcador sería una consulta por fila.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Todos los hitos que quien consulta puede ver, en todos los proyectos

Todos los hitos que puedes ver en todos los proyectos, en una sola llamada, para los marcadores de un roadmap. La visibilidad sigue a los proyectos que puedes abrir. project__in reduce ese conjunto y nunca lo amplía: un uuid desconocido y el uuid de otra organización devuelven un resultado vacío. Las filas incluyen project como referencia.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Las vistas guardadas de esta persona dentro de un proyecto

Tus vistas guardadas dentro de un proyecto: conjuntos de filtros con nombre que abarcan todos sus tableros. Las vistas son personales y tienen alcance por proyecto, así que el mismo nombre puede existir en dos proyectos. Requiere una persona: las keys de agente y de la organización se rechazan; una API key personal 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Requiere una persona: llámalo con una sesión iniciada, un token de usuario del CLI o una API key personal. Una key de agente o de la organización recibe `403 insufficient_scope`.

Miembros de un proyecto

Visible para cualquiera que pueda ver el proyecto. En un proyecto members, esta es la membresía que da visibilidad del proyecto y sus tableros.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Requiere una persona: llámalo con una sesión iniciada, un token de usuario del CLI o una API key personal. Una key de agente o de la organización recibe `403 insufficient_scope`.

Listar los adjuntos de un proyecto

Los adjuntos del proyecto, ordenados por posición. Cualquiera que pueda ver el proyecto puede listar sus adjuntos; un proyecto que no puedes ver es 404. Cada url es un enlace de descarga. No lo guardes: conserva el uuid del adjunto y vuelve a leerlo cuando necesites el archivo. Para mostrar una imagen en la descripción del proyecto, refiérete a ella como attachment:{uuid} y resuélvela al renderizar con el url reciente de esta 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Descargar los bytes de un adjunto de un proyecto

Transmite el archivo con el tipo de contenido registrado al subirlo, X-Content-Type-Options: nosniff y Cache-Control: no-store. Nunca redirige al almacenamiento. Cualquiera que pueda ver el proyecto puede descargarlo.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Listar los adjuntos del hito

Los adjuntos listos del hito, ordenados por posición. Cualquiera que pueda ver el proyecto puede listarlos; un proyecto que no puedes ver es 404. Cada url es un enlace de descarga. No lo guardes: conserva el uuid del adjunto y vuelve a leerlo cuando necesites el archivo. Refiérete a él desde la description del hito con un marcador attachment:{uuid} y resuélvelo con GET /v1/plan/attachments/resolve/ al 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Obtener un adjunto del hito

Un adjunto del hito. Cualquiera que pueda ver el proyecto puede leerlo.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Descargar los bytes de un adjunto del hito

Transmite el archivo con el tipo de contenido registrado al subirlo, X-Content-Type-Options: nosniff y Cache-Control: no-store. Nunca redirige al almacenamiento. Cualquiera que pueda ver el proyecto puede descargarlo.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Obtener una actualización de proyecto

Una nota de estado, con sus attachments listos incluidos, provenance, edited_at (nulo hasta la primera edición) y 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Listar los adjuntos de la actualización

Los adjuntos listos de la actualización, ordenados por posición. Cualquiera que pueda ver el proyecto puede listarlos; un proyecto que no puedes ver es 404. Cada url es un enlace de descarga. No lo guardes: conserva el uuid del adjunto y vuelve a leerlo cuando necesites el archivo. Refiérete a él desde el body de la actualización con un marcador attachment:{uuid} y resuélvelo con GET /v1/plan/attachments/resolve/ al 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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Obtener un adjunto de la actualización

Un adjunto de la actualización. Cualquiera que pueda ver el proyecto puede leerlo.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Descargar los bytes de un adjunto de la actualización

Transmite el archivo con el tipo de contenido registrado al subirlo, X-Content-Type-Options: nosniff y Cache-Control: no-store. Nunca redirige al almacenamiento. Cualquiera que pueda ver el proyecto puede descargarlo.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Listar quién reaccionó a una actualización del proyecto

Todos los que reaccionaron a la actualización, del más antiguo al más reciente, como una página. emoji la reduce a un solo emoji. La misma forma que la lista de reacciones de un comentario.

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`.
• Límite de solicitudes: 120 lecturas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.