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

# Update agent versions configuration

> Updates the configuration of agent versions for the requested report group by full replacement. This endpoint is only available when the report group has an assigned product configuration with enabled self-management of versions; otherwise returns 409. Enablement of this capability is a platform configuration managed outside the API client. The list of reporting groups indicates this capability via the "can_manage_agent_versions" field. Updating with API key requires "Organization Administrator" role.



## OpenAPI

````yaml /en/api-reference/openapi.en-v2.json put /v2/organizations/{organization_id}/reporting-groups/{reporting_group_id}/agent-versions
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 2.0.0
  description: Public REST API for portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags:
  - name: Digital activity
    description: Creation of core process groups by organization
  - name: Roles
    description: Endpoint de creacion de roles de organizacion
  - name: Usuarios
    description: Endpoint de creacion de usuarios de organizacion
  - name: Grupos de workspaces
    description: Endpoints de gestión de grupos de workspaces
  - name: Workspaces
    description: Endpoint de eliminacion de workspaces de la organizacion
  - 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 organizacion
  - 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 sesion de la organizacion
  - name: Tenants
    description: Endpoints de gestión de tenants
paths:
  /v2/organizations/{organization_id}/reporting-groups/{reporting_group_id}/agent-versions:
    put:
      tags:
        - Reporting Groups
      summary: Update agent versions configuration
      description: >-
        Updates the configuration of agent versions for the requested report
        group by full replacement. This endpoint is only available when the
        report group has an assigned product configuration with enabled
        self-management of versions; otherwise returns 409. Enablement of this
        capability is a platform configuration managed outside the API client.
        The list of reporting groups indicates this capability via the
        "can_manage_agent_versions" field. Updating with API key requires
        "Organization Administrator" role.
      operationId: update_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: Identifier of the target organization.
          example: 507f1f77bcf86cd799439011
        - name: reporting_group_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identifier of the target report group.
          example: 507f1f77bcf86cd799439022
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateReportingGroupAgentVersionsRequestV2'
            examples:
              full_replacement:
                summary: Full update
                value:
                  agent_auto_update: false
                  versions:
                    windows_cp:
                      early: latest
                      production: latest
                    windows:
                      early: 2.31.0
                      production: 2.30.4
                    macos:
                      early: latest
                      production: 1.10.0
                    linux:
                      early: latest
                      production: 1.12.0
      responses:
        '200':
          description: Agent versions successfully updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetReportingGroupAgentVersionsResponseV2'
              examples:
                ok_response:
                  summary: Group versions updated
                  value:
                    agent_auto_update: false
                    versions:
                      windows_cp:
                        early: latest
                        production: latest
                      windows:
                        early: 2.31.0
                        production: 2.30.4
                      macos:
                        early: latest
                        production: 1.10.0
                      linux:
                        early: latest
                        production: 1.12.0
        '400':
          $ref: '#/components/responses/BadRequest'
          description: Invalid route or body parameters.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: Unauthorized.
        '404':
          $ref: '#/components/responses/NotFound'
          description: Report group not found.
        '409':
          $ref: '#/components/responses/Conflict'
          description: The group does not allow self-management of agent versions.
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    UpdateReportingGroupAgentVersionsRequestV2:
      type: object
      properties:
        agent_auto_update:
          type: boolean
        versions:
          $ref: '#/components/schemas/ReportingGroupAgentVersionsV2'
      required:
        - agent_auto_update
        - versions
    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: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Conflict:
      description: Conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````