title: Bulk upgrade agents
type: object
properties:
  version:
    type: string
    description: version to upgrade to
  source_uri:
    type: string
    description: alternative upgrade binary download url
  rollout_duration_seconds:
    type: number
    description: rolling upgrade window duration in seconds
  start_time:
    type: string
    description: start time of upgrade in ISO 8601 format
  agents:
    oneOf:
      - type: string
        description: KQL query string, leave empty to action all agents
      - type: array
        items:
          type: string
        description: list of agent IDs
  force:
    type: boolean
    description: Force upgrade, skipping validation (should be used with caution)
required:
  - agents
  - version