Plan · Tableros

Listar tableros

Los tableros que puedes ver, en una página. Filtra por project, busca con search, por fechas con start_date / end_date y trae los tableros archivados con include_archived. Una key de agente o de la organización solo ve los tableros visibles para la organización; una key personal ve lo que ve su persona.

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

Un tablero por su uuid. Un tablero que no puedes ver responde 404, igual que uno que no 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`.
• 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 estados de un tablero, en orden de columna

Los estados del flujo de trabajo del tablero (sus columnas), ordenados por posición. Cada uno tiene una category (como in_progress) que se mantiene aunque se renombre el estado. Agrega include_archived=true para ver los estados archivados.

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

El tablero completo, con sus estados y sus tareas, en un solo viaje de ida y vuelta

Una llamada renderiza un tablero: una entrada en groups por columna, en orden de columnas, cada una con sus primeras tareas en orden de rank, el task_count real de la columna y has_more. Pagina el resto de una columna con GET /v1/plan/tasks/?board=…&state=….

Guarda delta_cursor y cambia al feed de cambios para cada lectura posterior. Responde If-None-Match con 304. …/snapshot/ es un alias con la misma respuesta. Los parámetros de consulta desconocidos y los valores de filtro no válidos devuelven 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`.
• 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.

Qué cambió en este tablero desde una marca de tiempo. NO es paginación

Un feed de cambios, no una página: sin count, next ni previous. Envía el cursor de tu respuesta anterior (o el delta_cursor de la instantánea) tal cual como updated_since; nunca lo calcules con tu propio reloj.

La entrega es al menos una vez, así que una fila escrita en el mismo instante que tu cursor se envía de nuevo en lugar de perderse. Las entradas se compactan a una por tarea (gana la fila actual). states es null a menos que se haya creado, renombrado, reordenado o archivado una columna; cuando viene definido, reemplaza toda tu lista de columnas.

Consulta de nuevo después de poll_after_seconds (15 s, duplicándose hasta 120 s mientras el tablero está inactivo, y se reinicia con cualquier cambio). Pausa mientras la página está oculta y actualiza cuando vuelve a ser visible. Si truncated es true, consulta de nuevo de inmediato. Los cursores de más de 7 días devuelven 400 delta_window_expired: vuelve a leer la instantánea. El polling es el transporte de 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`.
• Límite de solicitudes: 240 consultas al feed de cambios 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 quien llama para este tablero

Tus vistas guardadas de este tablero. Las vistas son personales. 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/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`.
• 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`.

Buscar personas que se pueden mencionar en un tablero

La lista para los selectores de responsable y participantes, con búsqueda por q (nombre, handle o id externo, nunca una dirección de correo completa). No uses la lista de miembros para los selectores: solo muestra permisos explícitos y suele estar vacía en tableros visibles para toda la organización.

Las personas que no pueden ver el tablero nunca aparecen, aunque coincidan con q, igual que la regla que las rechaza como responsables o participantes (participant_cannot_access_board). limit (25 por defecto) y offset recorren toda la lista en un orden estable.

Las filas son {uuid, name, handle, avatar_url, has_photo, kind}, sin correo. avatar_url y has_photo significan lo mismo que en el responsable de una tarea: cuando has_photo es false, muestra las iniciales; en una fila agent son null y false. Identifica los chips de mención por uuid, nunca por handle: handle no es único dentro de una organización, así que muestra name para distinguir. kinds=agent lista los agentes del espacio de trabajo, pero todavía no se puede mencionar a un agente; no construyas una mención a partir de una fila 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`.
• 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 tablero

Solo los permisos de membresía explícitos, nunca la lista completa de la organización, por lo que los tableros visibles para la organización suelen devolver una lista vacía. Úsalo para gestionar quién puede ver un tablero solo para miembros; para los selectores usa …/mentionables/. Un administrador de la organización puede leer esta lista sin obtener visibilidad de las tareas del tablero.

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`.
• 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 las etiquetas de la organización (verificación de acceso al tablero)

Las etiquetas de la organización, tras la verificación de acceso de este tablero, para que la configuración del tablero pueda gestionarlas sin salir de la API de Plan. Aplica etiquetas a las tarjetas con el PATCH de la tarea, el endpoint de lote de etiquetas o el set_labels masivo.

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

Una vista guardada por uuid

Se puede leer cuando es tu propia vista, o una vista shared o board_default de un tablero que puedes ver. Cualquier otra, incluida la vista personal de otra persona, es 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`.
• 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 del tablero

Los adjuntos listos del tablero, ordenados por posición, como una página. Cualquiera que pueda ver el tablero puede listarlos; un tablero 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.

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

Un adjunto del tablero. Cualquiera que pueda ver el tablero puede leerlo.

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

Los bytes del archivo, con el tipo de contenido registrado, a través de la API en vez del enlace de medios. Un adjunto cuya subida aún no terminó es 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`.
• 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.