> ## 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 grupos de reporte

> Recupera una lista paginada de grupos de reporte que pertenecen a la organización especificada. Admite filtrado y ordenación sobre propiedades de los grupos de reporte. Los filtros se proporcionan como una cadena JSON siguiendo la estructura AST de FilterNode. Los resultados se devuelven en páginas con metadatos de paginación.



## OpenAPI

````yaml /api-reference/openapi-v1.json get /v1/organizations/{organization_id}/reporting-groups
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}/reporting-groups:
    get:
      tags:
        - Grupos de reporte
      summary: Listar grupos de reporte
      description: >-
        Recupera una lista paginada de grupos de reporte que pertenecen a la
        organización especificada. Admite filtrado y ordenación sobre
        propiedades de los grupos de reporte. Los filtros se proporcionan como
        una cadena JSON siguiendo la estructura AST de FilterNode. Los
        resultados se devuelven en páginas con metadatos de paginación.
      operationId: listReportingGroups
      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
          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).
            Campos de ordenación válidos: 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. Es ascendente de forma predeterminada si
            no se proporciona sufijo.
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: >-
            Lista separada por comas de campos para incluir en cada elemento de
            grupo de reporte. Campos 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 campo id
            siempre se incluye.
          example: name,effective_agent_settings,execute_flexx_analyzer_agent
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
            description: >-
              Filtra grupos de reporte usando un objeto JSON. Especifica el
              campo a filtrar, el operador de comparación y el valor. Ejemplo:
              {"field": "name", "op": "eq", "value": "Grupo de reporte 1"}
            example: '{"field": "name", "op": "eq", "value": "Grupo de reporte 1"}'
          description: >-
            Filtra grupos de reporte por uno o más criterios. Proporciona una
            cadena JSON con AST de filtros. Filtra por cualquier campo devuelto
            en la respuesta. Para campos anidados usa notación de punto:
            overridden_agent_settings.remote_support,
            effective_agent_settings.remote_support,
            effective_agent_settings.uninstall_protection, etc. Operadores: eq,
            ne, gt, gte, lt, lte, in, nin, contains, startsWith, endsWith,
            between. Combina con and/or. Longitud máxima: 5120 caracteres.
          examples:
            simple:
              summary: Filtrar por nombre del grupo de reporte
              description: >-
                Devuelve grupos de reporte cuyo nombre contiene el texto
                proporcionado.
              value: '{"field": "name", "op": "contains", "value": "producción"}'
            complex-and:
              summary: Filtrar por configuración anidada y bandera de ejecución
              description: >-
                Devuelve grupos donde la protección de desinstalación está
                desactivada y la ejecución del analizador 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: Combinar condiciones OR y AND
              description: >-
                Coincide con múltiples patrones de nombre y requiere soporte
                remoto interactivo.
              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 de elementos por página
      responses:
        '200':
          description: >-
            Lista paginada de grupos de reporte recuperada correctamente. La
            respuesta incluye metadatos de paginación y el arreglo de datos de
            grupos de reporte.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportingGroupListItemV1ListResponseV1'
        '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:
    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 grupo de reporte
        name:
          type: string
          description: Nombre del grupo de reporte
        organization_id:
          type: string
          nullable: true
          description: Identificador de organización
        product_config_id:
          type: string
          nullable: true
          description: Identificador de configuración de producto
        fishing_pattern:
          type: string
          nullable: true
          description: Nombre del patrón de fishing
        fishing_pattern_field:
          type: string
          enum:
            - full_name
            - description
            - ou
            - current_subnet
          nullable: true
          description: >-
            Campo sobre el que se aplica fishing_pattern. Valores posibles:
            full_name, description, ou, current_subnet.
        patch_policy_target_id:
          type: string
          nullable: true
          description: Identificador de patch policy target
        policy_reporting_group:
          type: string
          nullable: true
          description: Identificador de policy reporting group
        overridden_agent_settings:
          $ref: '#/components/schemas/ReportingGroupAgentSettingsV1'
          nullable: true
          description: Configuración del agente sobrescrita a nivel de grupo de reporte
        effective_agent_settings:
          $ref: '#/components/schemas/ReportingGroupEffectiveAgentSettingsV1'
          nullable: true
          description: Configuración efectiva del agente
        execute_flexx_analyzer_agent:
          type: boolean
          description: Si la ejecución del agente FlexxAnalyzer está habilitada
        can_manage_agent_versions:
          type: boolean
          description: >-
            Indica si el grupo de reporte permite la autogestión de versiones de
            agente según su configuración de producto asociada
        flexx_agent_portal_download:
          type: boolean
          description: >-
            Si la descarga de FlexxAgent desde el portal está habilitada para la
            organización del grupo
        intermediate_device_1_id:
          type: string
          nullable: true
          description: ID de Workspace del primer dispositivo intermedio
        intermediate_device_2_id:
          type: string
          nullable: true
          description: ID de Workspace del segundo dispositivo intermedio
        intermediate_device_3_id:
          type: string
          nullable: true
          description: ID de Workspace del tercer dispositivo intermedio
      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ón de soporte remoto
        collect_device_location:
          type: boolean
          nullable: true
          description: Si la recopilación de ubicación del dispositivo está habilitada
        auto_update_agents:
          type: boolean
          nullable: true
          description: Si la actualización automática de agentes está habilitada
        collect_event_logs:
          type: boolean
          nullable: true
          description: Si la recopilación de registros de eventos está habilitada
        event_log_ids:
          type: string
          nullable: true
          description: IDs de registros de eventos
        event_logs_recurrence:
          type: number
          nullable: true
          description: Recurrencia de registros de eventos
        collect_disks:
          type: boolean
          nullable: true
          description: Si la recopilación de discos está habilitada
        collect_services:
          type: boolean
          nullable: true
          description: Si la recopilación de servicios está habilitada
        collect_pnp_events:
          type: boolean
          nullable: true
          description: Si la recopilación de eventos PnP está habilitada
        collect_public_ip:
          type: boolean
          nullable: true
          description: Si la recopilación de IP pública está habilitada
        fra_system_actions_role:
          type: string
          nullable: true
          description: Rol de acciones del sistema FRA
        unified_reporting:
          type: string
          nullable: true
          description: Configuración de reporte unificado
        unified_operations:
          type: string
          nullable: true
          description: Configuración de operaciones unificadas
        uninstall_protection:
          type: string
          nullable: true
          enum:
            - 'off'
            - 'on'
          description: >-
            Valores posibles: off, on. Si no hay un estado aplicable, devuelve
            null.
        web_apps:
          type: boolean
          nullable: true
          description: Si las web apps están habilitadas
    ReportingGroupEffectiveAgentSettingsV1:
      type: object
      description: >-
        Ajustes efectivos del agente (incluye campos de configuración del
        producto más sobrescrituras)
      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: >-
            Valores posibles: off, on. Si no hay un estado aplicable, devuelve
            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: 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

````