# Listar tareas

> plazbot tasks list: tareas del workspace, filtrables por nombre, estado de proyecto, oportunidad o vista.

Fuente: https://developers.plazbot.com/cli/tasks/list/

### 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
plazbot 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](https://developers.plazbot.com/cli/ia/scripting).

### Ejemplos

```bash
# Últimas tareas
plazbot tasks list

# Tareas de una oportunidad, en JSON
plazbot tasks list --deal opp_AbcDef123 --json

# Página 2, de 20 en 20
plazbot tasks list --limit 20 --cursor 2
```

### Resultado

```text
Tasks (1)
────────────────────────────────────────
┌───────────────┬─────────────────────────────┬─────────┬──────────┬─────┬──────────────────┐
│ ID            │ Name                        │ Project │ Assigned │ Due │ Created          │
├───────────────┼─────────────────────────────┼─────────┼──────────┼─────┼──────────────────┤
│ tsk_AbcDef123 │ Enviar propuesta a ACME     │ —       │ 0        │ —   │ 2026-08-30 13:26 │
└───────────────┴─────────────────────────────┴─────────┴──────────┴─────┴──────────────────┘
```

| 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
{
"data": [
  {
    "id": "tsk_AbcDef123",
    "dealId": "opp_AbcDef123",
    "name": "Enviar propuesta a ACME",
    "description": "",
    "statusId": 1,
    "projectStatusId": "mos_AbcDef123",
    "expirationDate": null,
    "asignedUsers": "",
    "subTask": [],
    "comments": [],
    "createdByInformation": { "userId": "usr_AbcDef123", "fullName": "Ana Pérez" },
    "creationDate": "2026-08-30T13:26:44.803Z"
  }
],
"nextCursor": "2"
}
```

### Errores comunes

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