# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Acronis Agent Management REST Agent Updates API
  version: 1.0.0
extends: openapi/acronis-agent-updates-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/agents/update:force'].post
  update:
    x-apievangelist-phrasing:
      intent: Force-update agents now
      effect: write
      questions:
      - How do I push an agent update immediately, ignoring the maintenance window?
      - Can I force only specific agents to update?
      instructions:
      - text: Force-update agents {agent_ids} now.
        slots:
          agent_ids: requestBody.agent_ids
      - text: Update agents {agent_ids} right away, bypassing maintenance windows.
        slots:
          agent_ids: requestBody.agent_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent_update_settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get agent update settings
      effect: read
      questions:
      - What update channel and maintenance window are agents using?
      - Are automatic agent updates enabled for a tenant?
      instructions:
      - text: Show agent update settings.
      - text: Get agent update settings for tenant {tenant_id}.
        slots:
          tenant_id: query.tenant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent_update_settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Change agent update settings
      effect: write
      questions:
      - How do I switch agents to a different update channel?
      - Can I set a maintenance window for automatic agent updates?
      instructions:
      - text: Set the agent update channel to {update_channel}.
        slots:
          update_channel: requestBody.update_channel
      - text: Set agent automatic updates to {automatic} with maintenance window {maintenance_window}.
        slots:
          automatic: requestBody.automatic
          maintenance_window: requestBody.maintenance_window
      method: generated
      generated: '2026-09-26'