> ## 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 grups d'informe

> Recupera una llista paginada de grups de report que pertanyen a l'organització especificada. Admet filtrat i ordenació sobre propietats dels grups de report. Els filtres es proporcionen com una cadena JSON seguint l'estructura AST de FilterNode. 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}/reporting-groups
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}/reporting-groups:
    get:
      tags:
        - Grups de report
      summary: Llistar grups d'informe
      description: >-
        Recupera una llista paginada de grups de report que pertanyen a
        l'organització especificada. Admet filtrat i ordenació sobre propietats
        dels grups de report. Els filtres es proporcionen com una cadena JSON
        seguint l'estructura AST de FilterNode. Els resultats es tornen en
        pàgines amb metadats de paginació.
      operationId: listReportingGroups
      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
          description: 'Número de pàgina (predeterminat: 1)'
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: >-
            Camp d'ordenació amb sufixe d'ordre opcional (:asc o :desc). Camps
            d'ordenació vàlids: name, organization_id, product_config_id,
            fishing_pattern, fishing_pattern_field, patch_policy_target_id,
            policy_reporting_group, overridden_agent_settings.*,
            effective_agent_settings.*, execute_flexx_analyzer_agent,
            can_manage_agent_versions, intermediate_device_1_id,
            intermediate_device_2_id, intermediate_device_3_id. És ascendent de
            forma predeterminada si no es proporciona sufixe.
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: >-
            Llista separada per comes de camps per incloure a cada element de
            grup de reporte. Camps seleccionables: id, name, organization_id,
            product_config_id, fishing_pattern, fishing_pattern_field,
            patch_policy_target_id, policy_reporting_group,
            overridden_agent_settings, effective_agent_settings,
            execute_flexx_analyzer_agent, can_manage_agent_versions,
            flexx_agent_portal_download, intermediate_device_1_id,
            intermediate_device_2_id, intermediate_device_3_id. El camp id
            sempre s'inclou.
          example: name,effective_agent_settings,execute_flexx_analyzer_agent
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
            description: >-
              Filtra grups de report usant un objecte JSON. Especifica el camp a
              filtrar, l'operador de comparació i el valor. Exemple: {"field":
              "name", "op": "eq", "value": "Grup de report 1"}
            example: '{"field": "name", "op": "eq", "value": "Grupo de reporte 1"}'
          description: >-
            Filtra grups de report per un o més criteris. Proporciona una cadena
            JSON amb AST de filtres. Filtra per qualsevol camp retornat en la
            resposta. Per a camps niats usa notació de punt:
            overridden_agent_settings.remote_support,
            effective_agent_settings.remote_support,
            effective_agent_settings.uninstall_protection, etc. Operadors: eq,
            ne, gt, gte, lt, lte, in, nin, contains, startsWith, endsWith,
            between. Combina amb and/or. Longitud màxima: 5120 caràcters.
          examples:
            simple:
              summary: Filtrar per nom del grup de report
              description: >-
                Retorna grups d'informes el nom dels quals conté el text
                proporcionat.
              value: '{"field": "name", "op": "contains", "value": "producción"}'
            complex-and:
              summary: Filtrar per configuració niada i bandera d'execució
              description: >-
                Retorna grups on la protecció de desinstal·lació està
                desactivada i l'execució de l'analitzador està habilitada.
              value: >-
                {"and": [{"field":
                "effective_agent_settings.uninstall_protection", "op": "eq",
                "value": "off"}, {"field": "execute_flexx_analyzer_agent", "op":
                "eq", "value": true}]}
            complex-or-and:
              summary: Combina condicions OR i AND
              description: >-
                Coincideix amb múltiples patrons de nom i requereix suport remot
                interactiu.
              value: >-
                {"and": [{"or": [{"field": "name", "op": "contains", "value":
                "prod"}, {"field": "name", "op": "contains", "value":
                "stage"}]}, {"field": "effective_agent_settings.remote_support",
                "op": "eq", "value": "INTERACTIVE"}]}
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            maximum: 100
            minimum: 1
          description: Número d'elements per pàgina
      responses:
        '200':
          description: >-
            Llista paginada de grups de report recuperada correctament. La
            resposta inclou metadats de paginació i l'arranjament de dades de
            grups de report.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportingGroupListItemV1ListResponseV1'
        '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:
    ReportingGroupListItemV1ListResponseV1:
      type: object
      properties:
        has_next:
          type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/ReportingGroupListItemV1'
      required:
        - has_next
        - data
    ReportingGroupListItemV1:
      type: object
      properties:
        id:
          type: string
          description: ID del grup de report
        name:
          type: string
          description: Nom del grup de report
        organization_id:
          type: string
          nullable: true
          description: Identificador d'organització
        product_config_id:
          type: string
          nullable: true
          description: Identificador de configuració de producte
        fishing_pattern:
          type: string
          nullable: true
          description: Nom del patró de fishing
        fishing_pattern_field:
          type: string
          enum:
            - full_name
            - description
            - ou
            - current_subnet
          nullable: true
          description: >-
            Camp sobre el qual s'aplica fishing_pattern. Valors possibles:
            full_name, description, ou, current_subnet.
        patch_policy_target_id:
          type: string
          nullable: true
          description: Identificador de destinació de política de patch
        policy_reporting_group:
          type: string
          nullable: true
          description: Identificador de grup de report de política
        overridden_agent_settings:
          $ref: '#/components/schemas/ReportingGroupAgentSettingsV1'
          nullable: true
          description: Configuració de l'agent sobrescrita a nivell de grup de reporte
        effective_agent_settings:
          $ref: '#/components/schemas/ReportingGroupEffectiveAgentSettingsV1'
          nullable: true
          description: Configuració efectiva de l'agent
        execute_flexx_analyzer_agent:
          type: boolean
          description: Si l'execució de l'agent FlexxAnalyzer està habilitada
        can_manage_agent_versions:
          type: boolean
          description: >-
            Indica si el grup de report permet l'autogestió de versions d'agent
            segons la seva configuració de producte associada
        flexx_agent_portal_download:
          type: boolean
          description: >-
            Si la descàrrega de FlexxAgent des del portal està habilitada per a
            l'organització del grup
        intermediate_device_1_id:
          type: string
          nullable: true
          description: ID de Workspace del primer dispositiu intermedi
        intermediate_device_2_id:
          type: string
          nullable: true
          description: ID de Workspace del segon dispositiu intermedi
        intermediate_device_3_id:
          type: string
          nullable: true
          description: ID de Workspace del tercer dispositiu intermedi
      required:
        - id
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
    ReportingGroupAgentSettingsV1:
      type: object
      properties:
        remote_support:
          type: string
          nullable: true
          description: Configuració de suport remot
        collect_device_location:
          type: boolean
          nullable: true
          description: Si la recopilació d'ubicació del dispositiu està habilitada
        auto_update_agents:
          type: boolean
          nullable: true
          description: Si l'actualització automàtica d'agents està habilitada
        collect_event_logs:
          type: boolean
          nullable: true
          description: Si la recopilació de registres d'esdeveniments està habilitada
        event_log_ids:
          type: string
          nullable: true
          description: IDs de registres d'esdeveniments
        event_logs_recurrence:
          type: number
          nullable: true
          description: Recurrència de registres d'esdeveniments
        collect_disks:
          type: boolean
          nullable: true
          description: Si la recopilació de discos està habilitada
        collect_services:
          type: boolean
          nullable: true
          description: Si la recopilació de serveis està habilitada
        collect_pnp_events:
          type: boolean
          nullable: true
          description: Si la recopilació d'esdeveniments PnP està habilitada
        collect_public_ip:
          type: boolean
          nullable: true
          description: Si la recopilació d'IP pública està habilitada
        fra_system_actions_role:
          type: string
          nullable: true
          description: Rol d'accions del sistema FRA
        unified_reporting:
          type: string
          nullable: true
          description: Configuració de reporte unificat
        unified_operations:
          type: string
          nullable: true
          description: Configuració d'operacions unificades
        uninstall_protection:
          type: string
          nullable: true
          enum:
            - 'off'
            - 'on'
          description: >-
            Valors possibles: off, on. Si no hi ha cap estat aplicable, retorna
            null.
        web_apps:
          type: boolean
          nullable: true
          description: Si les aplicacions web estan habilitades
    ReportingGroupEffectiveAgentSettingsV1:
      type: object
      description: >-
        Ajustaments efectius de l'agent (inclou camps de configuració del
        producte més sobrescritures)
      properties:
        remote_support:
          type: string
          nullable: true
        collect_device_location:
          type: boolean
          nullable: true
        auto_update_agents:
          type: boolean
          nullable: true
        collect_event_logs:
          type: boolean
          nullable: true
        event_log_ids:
          type: string
          nullable: true
        event_logs_recurrence:
          type: number
          nullable: true
        collect_disks:
          type: boolean
          nullable: true
        collect_services:
          type: boolean
          nullable: true
        collect_pnp_events:
          type: boolean
          nullable: true
        collect_public_ip:
          type: boolean
          nullable: true
        fra_system_actions_role:
          type: string
          nullable: true
        unified_reporting:
          type: string
          nullable: true
        uninstall_protection:
          type: string
          nullable: true
          enum:
            - 'off'
            - 'on'
          description: >-
            Valors possibles: off, on. Si no hi ha cap estat aplicable, retorna
            null.
        resources_report_recurrence:
          type: number
          nullable: true
        profile_storage_report_recurrence:
          type: number
          nullable: true
        sync_broker_recurrence:
          type: number
          nullable: true
        detect_new_citrix_subscriptions:
          type: boolean
          nullable: true
        proxy_type:
          type: string
          nullable: true
        can_enable_flexx_agent_per_group:
          type: boolean
          nullable: true
        web_apps:
          type: boolean
          nullable: true
        fra_simplified_security:
          type: string
          nullable: true
  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

````