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

# Obtener configuración de versiones de agente

> Devuelve la configuración efectiva de versiones de agente para el grupo de reporte solicitado. Este endpoint solo está disponible cuando el grupo de reporte tiene asignada una configuración de producto con autogestión de versiones habilitada; en caso contrario devuelve 409. La habilitación de esta capacidad es una configuración de plataforma gestionada fuera del cliente API. El listado de reporting groups informa esta capacidad mediante el campo "can_manage_agent_versions". Para lectura con API key se requiere el permiso "Equipo de L3 de ingeniería" o el rol "Administrador de organización".



## OpenAPI

````yaml /api-reference/openapi-v2.json get /v2/organizations/{organization_id}/reporting-groups/{reporting_group_id}/agent-versions
openapi: 3.0.3
info:
  title: API Pública Portal
  version: 2.0.0
  description: API pública REST para Portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags:
  - name: Actividad digital
    description: Creación de grupos de procesos core por organización
  - name: Roles
    description: Endpoint de creaciÓn de roles de organización
  - name: Usuarios
    description: Endpoint de creación de usuarios de organización
  - name: Grupos de workspaces
    description: Endpoints de gestión de grupos de workspaces
  - name: Workspaces
    description: Endpoint de eliminacion de workspaces de la organización
  - name: Aplicaciones instaladas
    description: Endpoint de detalle de aplicación instalada de la organización
  - name: Autenticación
    description: Endpoints de autenticación y contexto de sesión
  - name: Microservicios
    description: Detalle de microservicios por organización
  - name: Operaciones
    description: Consulta de detalle de operaciones por organización
  - name: Organización
    description: Operaciones de organización
  - name: Objetivos de política de parches
    description: Endpoints de gestión de objetivos de política de parches
  - name: Configuraciones de producto
    description: Endpoints de gestión de configuraciones de producto
  - name: Grupos de reporte
    description: Operaciones sobre grupos de reporte
  - name: Sesiones
    description: Endpoint de detalle de sesión de la organización
  - name: Tenants
    description: Endpoints de gestión de tenants
paths:
  /v2/organizations/{organization_id}/reporting-groups/{reporting_group_id}/agent-versions:
    get:
      tags:
        - Grupos de reporte
      summary: Obtener configuración de versiones de agente
      description: >-
        Devuelve la configuración efectiva de versiones de agente para el grupo
        de reporte solicitado. Este endpoint solo está disponible cuando el
        grupo de reporte tiene asignada una configuración de producto con
        autogestión de versiones habilitada; en caso contrario devuelve 409. La
        habilitación de esta capacidad es una configuración de plataforma
        gestionada fuera del cliente API. El listado de reporting groups informa
        esta capacidad mediante el campo "can_manage_agent_versions". Para
        lectura con API key se requiere el permiso "Equipo de L3 de ingeniería"
        o el rol "Administrador de organización".
      operationId: get_reporting_group_agent_versions
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador de la organización objetivo.
          example: 507f1f77bcf86cd799439011
        - name: reporting_group_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identificador del grupo de reporte objetivo.
          example: 507f1f77bcf86cd799439022
      responses:
        '200':
          description: Versiones de agente recuperadas correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetReportingGroupAgentVersionsResponseV2'
              examples:
                ok_response:
                  summary: Versiones efectivas del grupo
                  value:
                    agent_auto_update: true
                    versions:
                      windows_cp:
                        early: latest
                        production: latest
                      windows:
                        early: 2.20.0
                        production: 2.19.3
                      macos:
                        early: latest
                        production: 1.9.2
                      linux:
                        early: latest
                        production: 1.11.0
        '400':
          $ref: '#/components/responses/BadRequest'
          description: Parámetros de ruta inválidos.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: No autorizado.
        '404':
          $ref: '#/components/responses/NotFound'
          description: Grupo de reporte no encontrado.
        '409':
          $ref: '#/components/responses/Conflict'
          description: El grupo no permite autogestión de versiones de agente.
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    GetReportingGroupAgentVersionsResponseV2:
      type: object
      properties:
        agent_auto_update:
          type: boolean
        versions:
          $ref: '#/components/schemas/ReportingGroupAgentVersionsV2'
      required:
        - agent_auto_update
        - versions
    ReportingGroupAgentVersionsV2:
      type: object
      properties:
        windows_cp:
          $ref: '#/components/schemas/ReportingGroupAgentVersionChannelPairV2'
        windows:
          $ref: '#/components/schemas/ReportingGroupAgentVersionChannelPairV2'
        macos:
          $ref: '#/components/schemas/ReportingGroupAgentVersionChannelPairV2'
        linux:
          $ref: '#/components/schemas/ReportingGroupAgentVersionChannelPairV2'
      required:
        - windows_cp
        - windows
        - macos
        - linux
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
    ReportingGroupAgentVersionChannelPairV2:
      type: object
      properties:
        early:
          type: string
        production:
          type: string
      required:
        - early
        - production
  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'
    Conflict:
      description: Conflicto
      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

````