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

# Actualitzar configuració de versions d'agent

> Actualitza per substitució completa la configuració de versions d'agent per al grup de reporte sol·licitat. Aquest endpoint només està disponible quan el grup de reporte té assignada una configuració de producte amb autogestió de versions habilitada; en cas contrari retorna 409. L'habilitació d'aquesta capacitat és una configuració de plataforma gestionada fora del client API. El llistat de reporting groups informa d'aquesta capacitat mitjançant el camp "can_manage_agent_versions". Per a actualització amb API key es requereix el rol "Administrador d'organització".



## OpenAPI

````yaml /ca/api-reference/openapi.ca-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: API pública REST per al portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags:
  - name: Activitat digital
    description: Creació de grups de processos core per organització
  - 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:
        - Grups de report
      summary: Actualitzar configuració de versions d'agent
      description: >-
        Actualitza per substitució completa la configuració de versions d'agent
        per al grup de reporte sol·licitat. Aquest endpoint només està
        disponible quan el grup de reporte té assignada una configuració de
        producte amb autogestió de versions habilitada; en cas contrari retorna
        409. L'habilitació d'aquesta capacitat és una configuració de plataforma
        gestionada fora del client API. El llistat de reporting groups informa
        d'aquesta capacitat mitjançant el camp "can_manage_agent_versions". Per
        a actualització amb API key es requereix el rol "Administrador
        d'organització".
      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: Identificador de l'organització objectiu.
          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 grup de reporte objectiu.
          example: 507f1f77bcf86cd799439022
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateReportingGroupAgentVersionsRequestV2'
            examples:
              full_replacement:
                summary: Actualització completa
                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: Versions d'agent actualitzades correctament.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetReportingGroupAgentVersionsResponseV2'
              examples:
                ok_response:
                  summary: Versions actualitzades del grup
                  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: Paràmetres de camí o cos invàlids.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: No autoritzat.
        '404':
          $ref: '#/components/responses/NotFound'
          description: Grup de reporte no trobat.
        '409':
          $ref: '#/components/responses/Conflict'
          description: El grup no permet autogestió de versions d'agent.
        '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: 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'
    Conflict:
      description: Conflicte
      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

````