*MCP › Referencia › Plataforma › Workflows* # Listar workflows > Devuelve los workflows de la cuenta con cómo se inicia cada uno y, para los manuales, el formulario de ejecución: los campos que `POST /api/v1/workflows/{workflowId}/runs` exige en `payload`, leídos de la versión publicada. No emite ninguna definición. Solo administradores. Ordenados por nombre. HERRAMIENTA `filmo_workflows_list` · `workflows:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `limit` | integer | No | Tamaño de página (1-500). Por defecto es 50. = `50` | | `cursor` | string | No | Cursor opaco de la página que se devuelve. Pasa el valor de `pagination.nextCursor` de la respuesta anterior; trátalo como opaco. | | `sort` | string | No | Orden: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: name, isActive, triggerType, createdAt, updatedAt. Por defecto, "name". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió. | | `isActive` | boolean | No | Filtra según si el workflow está activo (true) o en pausa (false). | | `triggerType` | string | No | Filtra por cómo se inicia el workflow: manual, schedule, webhook, event, signal o entity. `manual`, `schedule`, `webhook`, `event`, `signal`, `entity` | | `triggerTypes` | string[] | No | Filtra por triggerType, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. `manual`, `schedule`, `webhook`, `event`, `signal`, `entity` | | `includeTotal` | boolean | No | Ponlo en true para incluir `pagination.total`, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto. = `false` | | `dateFilters` | object | No | Filtros de fecha por campo. Una fecha sin hora (YYYY-MM-DD) se lee en la zona horaria del negocio; un instante ISO 8601 con desplazamiento se aplica tal cual con gte, lte, gt y lt, mientras que on lo amplía al día completo del negocio que lo contiene. Campos: created, updated. | | `dateFilters.created` | object | No | | | `dateFilters.created.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.created.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.created.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.created.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.created.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.updated` | object | No | | | `dateFilters.updated.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.updated.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.updated.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.updated.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.updated.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único del workflow. | | `name` | string | Nombre del workflow. | | `isActive` | boolean | true cuando el workflow está activo; false cuando está en pausa. | | `archivedAt` | string | Fecha en que se archivó en ISO 8601 UTC; null si no está archivado. | | `trigger` | object | Cómo se inicia el workflow y, si es manual, qué pide. | | `trigger.type` | string | Cómo se inicia el workflow: manual (una persona o la API lo ejecuta), schedule (cron), webhook (una petición entrante), event (ocurre algo en Filmo), signal (otro workflow) o entity (se ejecuta desde la página de un registro). Null si no tiene versión publicada. `manual`, `schedule`, `webhook`, `event`, `signal`, `entity` | | `trigger.event` | string | Para los triggers `event`, el evento de Filmo que escucha; null en caso contrario. | | `trigger.entity` | string | Para los triggers `entity`, el tipo de entidad sobre el que se ejecuta; null en caso contrario. | | `trigger.form` | object[] | Para los triggers `manual`, el formulario de ejecución: todos los campos listados son OBLIGATORIOS en `payload` al llamar a [`POST /api/v1/workflows/{workflowId}/runs`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/run-a-workflow). Vacío cuando el workflow no pide nada. | | `trigger.form.name` | string | Clave del campo en `payload` al ejecutar el workflow. | | `trigger.form.label` | string | Texto que ve la persona que lo ejecuta. | | `trigger.form.type` | object | Tipo declarado del valor, en el lenguaje de tipos de los workflows: `{"type":"string"}`, `{"type":"number"}`, `{"type":"boolean"}`, `{"type":"date","mode":"date"\|"datetime"}`, `{"type":"enum","options":[{"value","label"}]}`, `{"type":"shape","shape":[{"key","label","value":}]}`, `{"type":"list","item":}`, `{"type":"record","value":}` o `{"type":"tuple","tuple":[]}`. El valor enviado en `payload` se valida contra él. | | `currentVersion` | object | La versión publicada, que es la que se ejecuta y de la que se lee el formulario de ejecución; null cuando el workflow nunca se ha guardado. | | `currentVersion.version` | integer | Número de la versión publicada. | | `currentVersion.createdAt` | string | Cuándo se publicó, en ISO 8601 UTC. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_workflows_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_workflows_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "name": "Example", "isActive": true, "archivedAt": "2026-09-01T08:00:00Z", "trigger": { "type": "manual", "event": "", "entity": "", "form": [ { "name": "Example", "label": "Example", "type": { "key": "" } } ] }, "currentVersion": { "version": 1, "createdAt": "2026-09-01T08:00:00Z" }, "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z" } ], "pagination": { "nextCursor": "eyJvIjo1MH0", "hasMore": true, "total": 1 }, "meta": { "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## Prompts de ejemplo *Prompt* ```text ¿Qué workflows puedo ejecutar desde aquí? ``` ## La misma operación por REST Esta herramienta ejecuta [`GET /api/v1/workflows`](https://docs.filmo.io/es/rest-api/endpoint-reference/workflows/list-workflows). --- URL canónica: https://docs.filmo.io/es/mcp/tools/workflows/filmo-workflows-list Última actualización: 2026-10-25