# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Vault Manager Archives API
  version: 1.0.0
extends: openapi/acronis-archives-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['/archives'].get
  update:
    x-apievangelist-phrasing:
      intent: List backup archives
      effect: read
      questions:
      - How do I list the backup archives for a machine?
      - Can I find archives whose backups have malware detected?
      - Which archives were created by a particular backup plan?
      instructions:
      - text: List archives for agent {agentId}.
        slots:
          agentId: query.agentId
      - text: Show archives containing backups of resource {resourceId}.
        slots:
          resourceId: query.resourceId
      - text: Find archives created by backup plan {backupPlanId}.
        slots:
          backupPlanId: query.backupPlanId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/archives'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete archives for a resource
      effect: destructive
      questions:
      - How do I delete all backup archives of a resource?
      - Can I delete archives in just one vault?
      instructions:
      - text: Delete archives for resource {resourceId} with change tag {changeTag}.
        slots:
          resourceId: query.resourceId
          changeTag: query.changeTag
      - text: Delete resource {resourceId}'s archives in vault {vaultId}, tag {changeTag}.
        slots:
          resourceId: query.resourceId
          vaultId: query.vaultId
          changeTag: query.changeTag
      method: generated
      generated: '2026-09-26'
- target: $.paths['/archives/{archiveID}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List backups within an archive
      effect: read
      questions:
      - What backup points are inside this archive?
      - Can I list only the password-protected backups in an archive?
      instructions:
      - text: List backups in archive {archiveID}.
        slots:
          archiveID: path.archiveID
      - text: Show backups of type {backupType} in archive {archiveID}.
        slots:
          backupType: query.backupType
          archiveID: path.archiveID
      method: generated
      generated: '2026-09-26'