> ## 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.

# Llistar fluxos

> Recupera una llista paginada de fluxos pertanyents a l'organització especificada. Admet filtrat, ordenació i cerca en les propietats dels fluxos. Els resultats es tornen en pàgines amb metadats de paginació.



## OpenAPI

````yaml /ca/api-reference/openapi.ca-v1.json get /v1/organizations/{organization_id}/flows
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 1.0.0
  description: API pública REST per al portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/flows:
    get:
      tags:
        - Fluxos
      summary: Llistar fluxos
      description: >-
        Recupera una llista paginada de fluxos pertanyents a l'organització
        especificada. Admet filtrat, ordenació i cerca en les propietats dels
        fluxos. Els resultats es tornen en pàgines amb metadats de paginació.
      operationId: listFlows
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: El identificador únic de l'organització
          example: 507f1f77bcf86cd799439011
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: 'Número de pàgina (predeterminat: 1)'
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: >-
            Camp d'ordenació amb sufix d'ordre opcional (:asc o :desc), p. ex.,
            "name", "name:asc", "cooldown_minutes:desc". Usa ordre ascendent per
            defecte si no es proporciona sufix. Camps d'ordenació vàlids: 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: >-
            Llista separada per comes de camps que s'inclouran en cada element
            de flux. Camps seleccionables: id, name, description, type,
            detection_only, cooldown_minutes, enabled. El camp id sempre
            s'inclou.
          example: name,description,enabled
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
            pattern: ^.*$
          description: >-
            Filtra fluxos per un o més criteris. Proporciona un objecte JSON amb
            condicions de filtre. Pots filtrar per: id, name, description, type,
            detection_only, cooldown_minutes, enabled, init_text, ok_text,
            ko_text. Usa operadors de comparació (eq, ne, gt, gte, lt, lte, in,
            nin, contains, startsWith, endsWith, between) i combina múltiples
            condicions amb operadors lògics (and, or). Longitud màxima: 5120
            caràcters.
          examples:
            simple:
              summary: Filtrar per fluxos habilitats
              description: Retorna només fluxos habilitats.
              value: '{"field": "enabled", "op": "eq", "value": true}'
            complex-and:
              summary: Filtrar per tipus i mode de detecció
              description: Retorna fluxos de SESSIÓ que no són només de detecció.
              value: >-
                {"and": [{"field": "type", "op": "eq", "value": "SESSION"},
                {"field": "detection_only", "op": "eq", "value": false}]}
            complex-or-and:
              summary: Combina condicions OR i AND
              description: >-
                Coincideix amb múltiples camps de text i requereix fluxos
                habilitats.
              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 d'elements per 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: >-
            Codi d'idioma per a camps de text que admeten múltiples idiomes. En
            crear o actualitzar recursos, especifica l'idioma dels valors de
            text proporcionats. En recuperar recursos, determina quina variant
            d'idioma dels camps de text multilingües es retorna. Valors
            acceptats: 'en-EN' (anglès), 'es-ES' (espanyol), 'pt-BR'
            (portuguès), 'ca-ES' (català), 'eu-ES' (euskera). Usa 'es-ES' per
            defecte si no es proporciona.
      responses:
        '200':
          description: >-
            Llista paginada de fluxos recuperada correctament. La resposta
            inclou metadats de paginació i l'arranjament de dades de fluxos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlowListItemV1ListResponseV1'
        '400':
          $ref: '#/components/responses/BadRequest'
          description: >-
            Sol·licitud incorrecta. Causes comunes: - Paràmetres de paginació no
            vàlids - Paràmetre de ordenació no vàlid - Paràmetres de filtre no
            vàlids
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: No autoritzat - es requereix autenticació
        '404':
          $ref: '#/components/responses/NotFound'
          description: Organització no trobada
        '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: Temps d'espera en minuts
        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: Sol·licitud incorrecta
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: No autoritzat
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: No trobat
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Masses sol·licituds
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Error intern del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````