# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Account Management Locations API
  version: 1.0.0
extends: openapi/acronis-locations-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: 6
- target: $.paths['/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several infrastructure locations
      effect: read
      questions:
      - Can I look up several infrastructure locations by UUID at once?
      - How do I get details for a list of data center locations?
      instructions:
      - text: Fetch infrastructure locations {uuids}.
        slots:
          uuids: query.uuids
      - text: Show the locations with UUIDs {uuids}.
        slots:
          uuids: query.uuids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/locations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an infrastructure location
      effect: write
      questions:
      - How do I add a new data center location for my tenant?
      - Which tenant owns a newly created infrastructure location?
      instructions:
      - text: Create a location named {name} owned by tenant {owner_tenant_id}.
        slots:
          name: requestBody.name
          owner_tenant_id: requestBody.owner_tenant_id
      - text: Add infrastructure location {name} for {owner_tenant_id}.
        slots:
          name: requestBody.name
          owner_tenant_id: requestBody.owner_tenant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/locations/{location_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an infrastructure location
      effect: read
      questions:
      - What are the details of this one infrastructure location?
      - Can I fetch a location's name and owner by its ID?
      instructions:
      - text: Show location {location_id}.
        slots:
          location_id: path.location_id
      - text: Get infrastructure location {location_id}.
        slots:
          location_id: path.location_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/locations/{location_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename an infrastructure location
      effect: write
      questions:
      - How do I rename an infrastructure location?
      - Why do I need the location version to update it?
      instructions:
      - text: Rename location {location_id} to {name} at version {version}.
        slots:
          location_id: path.location_id
          name: requestBody.name
          version: requestBody.version
      - text: Change the name of infrastructure location {location_id} to {name}.
        slots:
          location_id: path.location_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/locations/{location_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an infrastructure location
      effect: destructive
      questions:
      - How do I remove an infrastructure location I no longer use?
      - Can I delete a location by its ID?
      instructions:
      - text: Delete location {location_id} at version {version}.
        slots:
          location_id: path.location_id
          version: query.version
      - text: Remove infrastructure location {location_id}.
        slots:
          location_id: path.location_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/locations/{location_id}/infra'].get
  update:
    x-apievangelist-phrasing:
      intent: List infrastructure components at a location
      effect: read
      questions:
      - Which infrastructure components are deployed at this location?
      - Can I see the storages registered in a given location?
      instructions:
      - text: List infrastructure components at location {location_id}.
        slots:
          location_id: path.location_id
      - text: Show what infrastructure runs in {location_id}.
        slots:
          location_id: path.location_id
      method: generated
      generated: '2026-09-26'