> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Listar workflows > Utilice este endpoint para recuperar una lista paginada de workflows. Puede filtrar resultados por estado. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml get /v1/workflows openapi: 3.1.0 info: description: >- Referencia completa de la API para los servicios de orquestación de workflows de Flowker, incluyendo gestión de catálogo, definiciones de workflows, configuraciones de ejecutores, configuraciones de proveedores y ejecuciones de workflows. title: API de Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore proveedores, ejecutores y disparadores integrados disponibles en el catálogo de Flowker. - name: Workflows API description: >- Cree, actualice, active, desactive, clone y elimine definiciones de workflows. - name: Executions API description: Inicie ejecuciones de workflows y rastree su estado y resultados. - name: Executor Configurations API description: >- Configure, pruebe y administre conexiones de ejecutores externos utilizadas por los nodos de workflow. - name: Provider Configurations API description: Configure, pruebe, habilite y deshabilite integraciones de proveedores. - name: Dashboard API description: >- Recupere resúmenes agregados de workflows y ejecuciones para dashboards operacionales. - name: Audit API description: >- Consulte y verifique eventos de auditoría para cumplimiento y visibilidad operacional. - name: Webhooks API description: >- Reciba callbacks de webhooks desde sistemas externos para disparar ejecuciones de workflows. paths: /v1/workflows: get: tags: - Workflows API summary: Listar workflows description: >- Utilice este endpoint para recuperar una lista paginada de workflows. Puede filtrar resultados por estado. operationId: listWorkflows parameters: - description: Filtrar resultados por estado. in: query name: status schema: enum: - draft - active - inactive type: string - description: >- Número máximo de elementos a retornar por página. Por defecto es 10. Debe estar entre 1 y 100. in: query name: limit schema: default: 10 maximum: 100 minimum: 1 type: integer - description: >- Cursor para paginación. Utilice el valor del campo `nextCursor` de una respuesta anterior para recuperar la siguiente página. in: query name: cursor schema: type: string - description: Campo por el cual ordenar los resultados. in: query name: sortBy schema: default: createdAt enum: - createdAt - updatedAt - name type: string - description: >- Dirección de ordenamiento. Utilice `ASC` para ascendente o `DESC` para descendente. in: query name: sortOrder schema: default: DESC enum: - ASC - DESC type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/WorkflowListOutput' description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos solicitados. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud estaba mal formada o contenía parámetros no válidos. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica un error interno inesperado. Si persiste, contacte al soporte. components: schemas: WorkflowListOutput: example: items: - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 name: Payment Notification Flow description: Receives a webhook trigger and logs the payment event. status: active nodes: - id: trigger-1 type: trigger name: Webhook Trigger position: x: 0 'y': 0 data: triggerId: webhook - id: log-event type: action name: Log Payment Event position: x: 200 'y': 0 data: action: log edges: - id: e1 source: trigger-1 target: log-event metadata: team: payments createdAt: '2026-03-17T14:30:00Z' updatedAt: '2026-03-17T14:31:00Z' nextCursor: '' hasMore: false properties: hasMore: description: Indica si hay más páginas disponibles. example: true type: boolean items: description: Lista de definiciones de workflows en la página actual. items: $ref: '#/components/schemas/WorkflowOutput' type: array nextCursor: description: >- Cursor a pasar en la siguiente solicitud para recuperar la página siguiente. example: eyJpZCI6ImExYjJjM2Q0In0= type: string type: object ErrorResponse: properties: code: description: Código de error legible por máquina con el prefijo FLK. example: FLK-0001 type: string message: description: Explicación del error legible por humanos. example: Invalid input provided type: string title: description: Título corto de categoría de error. example: Bad Request type: string required: - code - message - title type: object WorkflowOutput: example: id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 name: Payment Notification Flow description: Receives a webhook trigger and logs the payment event. status: active nodes: - id: trigger-1 type: trigger name: Webhook Trigger position: x: 0 'y': 0 data: triggerId: webhook - id: log-event type: action name: Log Payment Event position: x: 200 'y': 0 data: action: log edges: - id: e1 source: trigger-1 target: log-event metadata: team: payments environment: sandbox createdAt: '2026-03-17T14:30:00Z' updatedAt: '2026-03-17T14:31:00Z' properties: createdAt: description: Marca de tiempo de cuando se creó el workflow. example: '2026-03-17T14:30:00Z' format: date-time type: string description: description: Descripción legible por humanos del workflow. example: Receives a webhook trigger and logs the payment event. type: string edges: description: Conexiones entre nodos que definen el flujo de ejecución. items: $ref: '#/components/schemas/WorkflowEdgeOutput' type: array id: description: Identificador único del workflow. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 format: uuid type: string metadata: additionalProperties: type: object description: Pares clave-valor personalizados para etiquetar o categorizar. example: team: payments environment: sandbox type: object name: description: Nombre único del workflow. example: Payment Notification Flow type: string nodes: description: Los pasos que componen este workflow. items: $ref: '#/components/schemas/WorkflowNodeOutput' type: array status: description: >- Estado actual del ciclo de vida: `draft` (editable), `active` (ejecutable) o `inactive` (archivado). enum: - draft - active - inactive example: active type: string updatedAt: description: Marca de tiempo de la última actualización. example: '2026-03-17T15:00:00Z' format: date-time type: string type: object WorkflowEdgeOutput: properties: condition: description: Expresión de condición para aristas condicionales. example: steps.kyc_check.status == 'approved' type: string id: description: Identificador único de la arista. example: e1 type: string label: description: Etiqueta legible por humanos. example: On success type: string source: description: ID del nodo de origen. example: trigger-1 type: string sourceHandle: description: Conector en el nodo de origen. example: output-1 type: string target: description: ID del nodo de destino. example: log-event type: string type: object WorkflowNodeOutput: properties: data: additionalProperties: type: object description: Datos de configuración específicos del tipo de nodo. example: triggerId: webhook type: object id: description: Identificador único del nodo dentro del workflow. example: trigger-1 type: string name: description: Nombre para mostrar del nodo. example: Webhook Trigger type: string position: $ref: '#/components/schemas/PositionOutput' type: description: Tipo del nodo. example: trigger type: string type: object PositionOutput: properties: x: description: Posición horizontal en píxeles. example: 100 type: integer 'y': description: Posición vertical en píxeles. example: 200 type: integer type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue. ````