post:
  summary: Bulk upgrade agents
  tags:
    - Agents
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            type: object
            properties:
              actionId:
                type: string
    '400':
      $ref: ../components/responses/error.yaml
  operationId: bulk-upgrade-agents
  parameters:
    - $ref: ../components/headers/kbn_xsrf.yaml
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: ../components/schemas/bulk_upgrade_agents.yaml
        example:
          version: 8.4.0
          source_uri: https://artifacts.elastic.co/downloads/beats/elastic-agent
          rollout_duration_seconds: 3600
          agents: [agent1, agent2]
          start_time: 2022-08-03T14:00:00.000Z