> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar flujos

> Recupera una lista paginada de flujos pertenecientes a la organización especificada. Admite filtrado, ordenación y búsqueda en las propiedades de los flujos. Los resultados se devuelven en páginas con metadatos de paginación.



## OpenAPI

````yaml /api-reference/openapi-v1.json get /v1/organizations/{organization_id}/flows
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 1.0.0
  description: Api publica REST para portal
servers:
  - url: https://api.staging.flxwvdexternal.com
    description: Staging API server
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/flows:
    get:
      tags:
        - Flujos
      summary: Listar flujos
      description: >-
        Recupera una lista paginada de flujos pertenecientes a la organización
        especificada. Admite filtrado, ordenación y búsqueda en las propiedades
        de los flujos. Los resultados se devuelven en páginas con metadatos de
        paginación.
      operationId: listFlows
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: El identificador único de la organización
          example: 507f1f77bcf86cd799439011
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: 'Número de página (predeterminado: 1)'
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: >-
            Campo de ordenación con sufijo de orden opcional (:asc o :desc), p.
            ej., "name", "name:asc", "cooldown_minutes:desc". Usa orden
            ascendente por defecto si no se proporciona sufijo. Campos de
            ordenación válidos: id, name, description, type, detection_only,
            cooldown_minutes, enabled, init_text, ok_text, ko_text
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: >-
            Lista separada por comas de campos que se incluirán en cada elemento
            de flujo. Campos seleccionables: id, name, description, type,
            detection_only, cooldown_minutes, enabled. El campo id siempre se
            incluye.
          example: name,description,enabled
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
            pattern: ^.*$
          description: >-
            Filtra flujos por uno o más criterios. Proporciona un objeto JSON
            con condiciones de filtro. Puedes filtrar por: id, name,
            description, type, detection_only, cooldown_minutes, enabled,
            init_text, ok_text, ko_text. Usa operadores de comparación (eq, ne,
            gt, gte, lt, lte, in, nin, contains, startsWith, endsWith, between)
            y combina múltiples condiciones con operadores lógicos (and, or).
            Longitud máxima: 5120 caracteres.
          examples:
            simple:
              summary: Filtrar por flujos habilitados
              description: Devuelve solo flujos habilitados.
              value: '{"field": "enabled", "op": "eq", "value": true}'
            complex-and:
              summary: Filtrar por tipo y modo de detección
              description: Devuelve flujos SESSION que no son solo de detección.
              value: >-
                {"and": [{"field": "type", "op": "eq", "value": "SESSION"},
                {"field": "detection_only", "op": "eq", "value": false}]}
            complex-or-and:
              summary: Combinar condiciones OR y AND
              description: >-
                Coincide con múltiples campos de texto y requiere flujos
                habilitados.
              value: >-
                {"and": [{"or": [{"field": "name", "op": "contains", "value":
                "backup"}, {"field": "description", "op": "contains", "value":
                "backup"}]}, {"field": "enabled", "op": "eq", "value": true}]}
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            maximum: 100
            minimum: 1
          description: Número de elementos por página
        - name: Accept-Language
          in: header
          required: false
          schema:
            type: string
            enum:
              - en-EN
              - es-ES
              - pt-BR
              - ca-ES
              - eu-ES
            default: es-ES
          description: >-
            Código de idioma para campos de texto que admiten múltiples idiomas.
            Al crear o actualizar recursos, esto especifica el idioma de los
            valores de texto proporcionados. Al recuperar recursos, esto
            determina qué variante de idioma de los campos de texto multilingües
            se devuelve. Valores aceptados: 'en-EN' (inglés), 'es-ES' (español),
            'pt-BR' (portugués), 'ca-ES' (catalán), 'eu-ES' (euskera). Usa
            'es-ES' por defecto si no se proporciona.
      responses:
        '200':
          description: >-
            Lista paginada de flujos recuperada correctamente. La respuesta
            incluye metadatos de paginación y el arreglo de datos de flujos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlowListItemV1ListResponseV1'
        '400':
          $ref: '#/components/responses/BadRequest'
          description: >-
            Solicitud incorrecta. Causas comunes: - Parámetros de paginación no
            válidos - Parámetro de ordenación no válido - Parámetros de filtro
            no válidos
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: No autorizado - se requiere autenticación
        '404':
          $ref: '#/components/responses/NotFound'
          description: Organización no encontrada
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    FlowListItemV1ListResponseV1:
      type: object
      properties:
        has_next:
          type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/FlowListItemV1'
      required:
        - has_next
        - data
    FlowListItemV1:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        type:
          type: string
          enum:
            - session
            - workspace
        detection_only:
          type: boolean
        cooldown_minutes:
          type: number
          description: Tiempo de espera en minutos
        enabled:
          type: boolean
      required:
        - id
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
  responses:
    BadRequest:
      description: Solicitud incorrecta
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: No autorizado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: No encontrado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Demasiadas solicitudes
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Error interno del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````