# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Maps Alias Service Aliases API
  version: 1.0.0
extends: openapi/microsoft-azure-aliases-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: 5
- target: $.paths['/aliases'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Maps Creator aliases
      effect: read
      questions:
      - Which aliases have I created for my indoor map data?
      - Can I see every Creator alias I have made so far?
      instructions:
      - text: List all my Azure Maps Creator aliases.
      - text: List the Creator aliases on the Azure Maps account with key {subscription_key}.
        slots:
          subscription_key: query.subscription-key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/aliases'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Creator alias
      effect: write
      questions:
      - How do I create a stable alias for my indoor map resources?
      - Can I assign an alias to a Creator data item at the moment I create it?
      instructions:
      - text: Create a new Creator alias.
      - text: Create an alias pointing at Creator data item {item}.
        slots:
          item: query.creatorDataItemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/aliases/{aliasId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Creator alias
      effect: read
      questions:
      - Which Creator resource does an alias currently point to?
      - When was an alias last updated?
      instructions:
      - text: Get the details of alias {alias}.
        slots:
          alias: path.aliasId
      - text: Show what resource alias {alias} references.
        slots:
          alias: path.aliasId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/aliases/{aliasId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Point an existing alias at a Creator resource
      effect: write
      questions:
      - How do I repoint an existing alias to a new version of my indoor map?
      - Can an alias reference another alias instead of a Creator item?
      instructions:
      - text: Assign alias {alias} to Creator data item {item}.
        slots:
          alias: path.aliasId
          item: query.creatorDataItemId
      - text: Repoint existing alias {alias} at resource {item}.
        slots:
          alias: path.aliasId
          item: query.creatorDataItemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/aliases/{aliasId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Creator alias
      effect: destructive
      questions:
      - Does deleting an alias also delete the indoor map it points to?
      - Can I remove old aliases to make room for new content?
      instructions:
      - text: Delete alias {alias}.
        slots:
          alias: path.aliasId
      - text: Remove unused Creator alias {alias}.
        slots:
          alias: path.aliasId
      method: generated
      generated: '2026-09-26'