Plan · Inicio y búsqueda

Las tareas del usuario que llama

Tus tareas, lo mismo que GET /v1/plan/tasks/?owner=me más la opción scope. Requiere una persona: una key de agente o de la organización recibe 403 insufficient_scope, nunca una lista vacía; una API key personal 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`.
• 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`.

Conteos de las pestañas de tareas personales

Conteos con alcance de quien llama para el trabajo del que es responsable, en el que participa, en el que está involucrado y vencido. Los cuatro enteros de nivel superior son totales de población en todo el ciclo de vida: owned cuenta todas las tareas de las que quien llama es responsable, estén abiertas, terminadas o canceladas. overdue es la excepción y solo cubre owned, excluyendo ya el trabajo archivado y terminal. by_scope contiene los números calificados por estado, para que una insignia pueda decir "N abiertas" sin una segunda solicitud. open se decide por la CATEGORÍA del estado, exactamente como lo decide ?state=open; overdue significa abierta Y vencida; blocked usa el único predicado de bloqueador activo. Cada número se calcula en el mismo agregado único sobre la misma raíz de visibilidad. by_scope.<scope>.total es igual, por construcción, al entero de nivel superior con el mismo nombre.

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

Tableros visitados recientemente por quien llama

Tableros que abriste recientemente, los más recientes primero, según lo registrado por POST /v1/plan/boards/{board_id}/visit/. Los tableros ocultos, archivados y de otras organizaciones se omiten en lugar de generar un error. Requiere una persona (una key de agente o de la organización recibe 403; una API key personal funciona).

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

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

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

Eventos de tareas relevantes para notificar a quien llama

Tu bandeja: eventos de tareas que merecen tu atención, del más reciente al más antiguo, en una página. mentioned=true conserva solo los eventos en los que alguien te mencionó; type conserva un tipo de evento. Ambos se combinan, y count y la paginación son exactos, así que no hay páginas vacías.

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

Conteo de no leídos en la bandeja de entrada de quien llama

Cuántos elementos de la bandeja aún no leíste, para una insignia. Acepta los mismos filtros que la lista de la bandeja, así la insignia de cada pestaña cuenta exactamente sus filas: mentioned=true para Menciones, type=task.owner_changed para Asignadas. Sin parámetros cuenta toda la bandeja. Más barato que listar la bandeja.

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

Feed de actividad de la organización para Plan Home

Eventos paginados que puedes abrir, enriquecidos con tarjetas de tarea y changes[{field, from, to}] resueltos para mostrar. Las tareas que no puedes ver se omiten aunque su tablero sea visible.

Solo se aceptan los parámetros listados aquí: cualquier otro parámetro de consulta es 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`.
• 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.

Leer el cursor de lectura de actividad de quien llama

Tu cursor de lectura de actividad: el momento hasta el que leíste el feed de actividad. Es null hasta que lo fijes.

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`.
• 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 las etiquetas de la organización

La taxonomía de etiquetas de la organización, compartida con formularios y check-ins. Prefiere este endpoint para las pantallas de configuración; la lista con alcance de tablero es la misma taxonomía tras una verificación de acceso al tablero.

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

Si Plan está disponible aquí y los topes del plan

Si Plan está disponible para tu organización y los topes de su plan. Es el único endpoint de Plan que nunca responde 402, así que llámalo antes de decidir si mostrar el producto.

enabled es la misma verificación que aplican todos los demás endpoints. reason es null cuando está habilitado; de lo contrario, rollout (tu organización todavía no está habilitada para la Beta) o usage (un administrador desactivó Plan). boards y projects informan {used, limit}, incluso cuando está deshabilitado; limit es null cuando el plan no tiene tope. El plan gratuito incluye hasta 3 tableros y 1 proyecto. used cuenta solo filas activas, así que archivar libera un lugar, y used > limit puede ocurrir en planes heredados.

Un invitado recibe 403 guest_not_allowed aquí, no 200 con enabled: false, y nunca ve los topes del plan.

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`.
• 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 trabajo planificado en una ventana, con sus aristas de dependencia y bandas de objetivos

El mismo conjunto filtrado que la lista de tareas, visto como una pregunta de planificación. rows son las tarjetas que se SUPERPONEN con la ventana; unscheduled cuenta las tarjetas coincidentes sin ninguna fecha; dependencies incluye solo aristas cuyos dos extremos están en rows, porque una flecha hacia una fila que el lector no puede ver es una línea hacia ninguna parte en la pantalla y una filtración fuera de ella. Selección de la ventana (gana la primera coincidencia): - from + to (fechas ISO): rango explícito; from puede estar en el pasado (por ejemplo, hoy−7 … hoy+21). Alias: window_from / window_to. - window_days: ayuda hacia adelante: desde hoy hasta hoy+N (rango inclusivo). - omitido: ventana predeterminada de 14 días hacia adelante desde hoy (con un filtro de tablero).

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

Buscar tareas y contenedores visibles para quien llama

Busca tareas (título, clave, descripción) y, con types, proyectos, tableros y objetivos que puedes ver.

La coincidencia es una búsqueda de subcadenas sin distinguir mayúsculas y minúsculas, no un ranking de texto completo. score es una ayuda de orden aproximada entre 0.6 y 1.0 (clave exacta 1.0, coincidencia en título o nombre 0.9 / 0.85, coincidencia en descripción 0.6), no una relevancia calibrada, y snippet es una ventana alrededor de la primera coincidencia. La respuesta lo repite en approximation. Las tareas ocultas y los tableros privados nunca aparecen.

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

La pantalla de inicio en una sola solicitud (HomePulse), o un agregado de salud del tablero (TaskPulse)

Dos modos, según la presencia de group_by.

HomePulse (sin group_by): el inicio de Plan en una sola solicitud: generated_at, counts enteros, tu my_preview, avances de tableros, objetivos y línea de tiempo, agent_summary y las bandas opcionales de include. La población se indica como scope: "viewer_visible": todas las tareas activas y no terminales que puedes ver, no toda la organización. Cada mosaico indica la consulta que lo reproduce: open → ?state=open, overdue → ?due_before=<today>&state=open, blocked → ?blocked=true&state=open.

TaskPulse (con group_by, p. ej. group_by=state): un agregado de salud del tablero con totales, rendimiento y tiempo de ciclo. Los conteos son solo enteros y no hay desglose por persona. Responde a If-None-Match con 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`.
• 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.

Tus tableros y vistas guardadas fijados

Todos tus pines, en orden de rank (1 es el primero). Un pin cuyo destino ya no puedes ver (un tablero archivado u oculto, o una vista guardada que ya no existe o dejó de estar compartida) se omite en lugar de dar error. La lista usa el sobre de lista estándar pero nunca se pagina: next y previous siempre son null, y contiene hasta 50 pines. 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/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`.
• 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`.