# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for File Sync & Share Devices API
  version: 1.0.0
extends: openapi/acronis-devices-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: 4
- target: $.paths['/devices'].get
  update:
    x-apievangelist-phrasing:
      intent: List devices
      effect: read
      questions:
      - How do I list all devices in a tenant?
      - Can I page through devices a set number at a time?
      instructions:
      - text: List devices in tenant {tenant_id}.
        slots:
          tenant_id: query.tenant_id
      - text: Show page {page} of devices, {per_page} per page.
        slots:
          page: query.page
          per_page: query.per_page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devices/{device_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's details
      effect: read
      questions:
      - What information is recorded for this device?
      - Can I look up a device by its UUID?
      instructions:
      - text: Show device {device_uuid}.
        slots:
          device_uuid: path.device_uuid
      - text: Get information about device {device_uuid} in tenant {tenant_id}.
        slots:
          device_uuid: path.device_uuid
          tenant_id: query.tenant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devices/{device_uuid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a device
      effect: write
      questions:
      - How do I change a device's details?
      - Can I update a device record within a specific tenant?
      instructions:
      - text: Update device {device_uuid} with {device}.
        slots:
          device_uuid: path.device_uuid
          device: requestBody.device
      - text: Save changes {device} to device {device_uuid}.
        slots:
          device: requestBody.device
          device_uuid: path.device_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/devices/{device_uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a device
      effect: destructive
      questions:
      - How do I remove a device?
      - Can I delete a device from a specific tenant?
      instructions:
      - text: Delete device {device_uuid}.
        slots:
          device_uuid: path.device_uuid
      - text: Remove device {device_uuid} from tenant {tenant_id}.
        slots:
          device_uuid: path.device_uuid
          tenant_id: query.tenant_id
      method: generated
      generated: '2026-09-26'