Listar tareas

Muestra las tareas del workspace. Puedes filtrar por nombre, por estado del proyecto, por oportunidad o aplicar los filtros de una vista guardada.

bash

01plazbot tasks list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Búsqueda	`-s, --search <text>`	No	Filtra por el nombre de la tarea.
Estado del proyecto	`--project-status <id>`	No	Solo las tareas en este estado de proyecto.
Oportunidad	`--deal <opportunityId>`	No	Solo las tareas de una oportunidad (`opp_...`).
Vista	`--view <viewId>`	No	Aplica los filtros de una vista guardada.
Por página	`--limit <n>`	No	Tareas por página (máximo `100`). Por defecto `50`.
Página	`--cursor <page>`	No	Número de página a traer (el `nextCursor` de la llamada anterior).
Todo	`--all`	No	Trae todas las páginas, hasta 5000 tareas.
Workspace	`-w, --workspace <id>`	No	Workspace donde se ejecuta. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona de la sesión.
JSON	`--json`	No	Imprime el resultado como JSON.

A diferencia de otros listados, la API pagina las tareas por número de página: nextCursor es el número de la página siguiente (por ejemplo "2") o null si no hay más. La salida JSON mantiene el formato { "data": [...], "nextCursor": ... }. Más detalles en Scripting y agentes de IA.

Ejemplos

bash

01# Últimas tareas
02plazbot tasks list
03 
04# Tareas de una oportunidad, en JSON
05plazbot tasks list --deal opp_AbcDef123 --json
06 
07# Página 2, de 20 en 20
08plazbot tasks list --limit 20 --cursor 2

Resultado

text

01  Tasks (1)
02  ────────────────────────────────────────
03┌───────────────┬─────────────────────────────┬─────────┬──────────┬─────┬──────────────────┐
04│ ID            │ Name                        │ Project │ Assigned │ Due │ Created          │
05├───────────────┼─────────────────────────────┼─────────┼──────────┼─────┼──────────────────┤
06│ tsk_AbcDef123 │ Enviar propuesta a ACME     │ —       │ 0        │ —   │ 2026-08-30 13:26 │
07└───────────────┴─────────────────────────────┴─────────┴──────────┴─────┴──────────────────┘

Columna	Descripción
ID	ID de la tarea (`tsk_...`).
Name	Nombre de la tarea.
Project	Proyecto de la tarea.
Assigned	Cantidad de usuarios asignados.
Due	Fecha de vencimiento (UTC).
Created	Fecha de creación (UTC).

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "tsk_AbcDef123",
05      "dealId": "opp_AbcDef123",
06      "name": "Enviar propuesta a ACME",
07      "description": "",
08      "statusId": 1,
09      "projectStatusId": "mos_AbcDef123",
10      "expirationDate": null,
11      "asignedUsers": "",
12      "subTask": [],
13      "comments": [],
14      "createdByInformation": { "userId": "usr_AbcDef123", "fullName": "Ana Pérez" },
15      "creationDate": "2026-08-30T13:26:44.803Z"
16    }
17  ],
18  "nextCursor": "2"
19}

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.
`Invalid --cursor "x".`	`--cursor` no es un número de página.	Usa el `nextCursor` de la llamada anterior (un número).