# 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 Styles API
  version: 1.0.0
extends: openapi/microsoft-azure-styles-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: 10
- target: $.paths['/styles/mapconfigurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Maps map configurations
      effect: read
      questions:
      - Which map configurations exist in my Azure Maps Creator account?
      - Can I see all the indoor map configurations I have created?
      instructions:
      - text: List all map configurations in my Creator account.
      - text: Show every indoor map configuration I have, using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/mapconfigurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a map configuration
      effect: write
      questions:
      - How do I create a map configuration that ties my indoor tilesets to styles?
      - Can I give a new map configuration an alias and a description?
      instructions:
      - text: Create a version {version} map configuration with alias {alias}.
        slots:
          version: requestBody.version
          alias: query.alias
      - text: Create a map configuration with default configuration {defaultConfiguration} and configurations {configurations}.
        slots:
          defaultConfiguration: requestBody.defaultConfiguration
          configurations: requestBody.configurations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/mapconfigurations/{mapConfigurationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a map configuration
      effect: read
      questions:
      - How do I download a map configuration and the images it references?
      - Can I fetch a map configuration by its alias instead of its ID?
      instructions:
      - text: Download map configuration {mapConfigurationId} as a zip.
        slots:
          mapConfigurationId: path.mapConfigurationId
      - text: Get the map configuration JSON for {mapConfigurationId}.
        slots:
          mapConfigurationId: path.mapConfigurationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/mapconfigurations/{mapConfigurationId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a map configuration
      effect: destructive
      questions:
      - How do I remove a map configuration I no longer use?
      - Can I delete an indoor map configuration by its ID?
      instructions:
      - text: Delete map configuration {mapConfigurationId}.
        slots:
          mapConfigurationId: path.mapConfigurationId
      - text: Remove the indoor map configuration {mapConfigurationId}.
        slots:
          mapConfigurationId: path.mapConfigurationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/mapconfigurations/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a map configuration creation status
      effect: read
      questions:
      - Has my map configuration finished being created yet?
      - Where do I poll the progress of a long-running map configuration create?
      instructions:
      - text: Check the status of map configuration operation {operationId}.
        slots:
          operationId: path.operationId
      - text: Poll the map configuration creation job {operationId}.
        slots:
          operationId: path.operationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles'].get
  update:
    x-apievangelist-phrasing:
      intent: List Azure Maps styles
      effect: read
      questions:
      - Which map styles are in my Azure Maps Creator account, including the default indoor ones?
      - Can I see all custom styles I have uploaded?
      instructions:
      - text: List all styles in my Creator account.
      - text: Show every map style available to me under API version {apiVersion}, default indoor styles included.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Azure Maps style
      effect: write
      questions:
      - How do I upload a custom indoor map style from a JSON or ZIP file?
      - Can I set an alias and description on a style when I create it?
      instructions:
      - text: Create a new map style with alias {alias}.
        slots:
          alias: query.alias
      - text: Upload a style described as {description}.
        slots:
          description: query.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/{styleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of a map style
      effect: read
      questions:
      - How do I fetch the definition of one style by its ID or alias?
      - Can I retrieve the predefined indoor dark style by its alias?
      instructions:
      - text: Get style {styleId}.
        slots:
          styleId: path.styleId
      - text: Show the details of map style {styleId}.
        slots:
          styleId: path.styleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/{styleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a map style
      effect: destructive
      questions:
      - How do I remove a custom style from my Creator account?
      - Can I delete a style I uploaded by mistake?
      instructions:
      - text: Delete style {styleId}.
        slots:
          styleId: path.styleId
      - text: Remove the custom map style {styleId}.
        slots:
          styleId: path.styleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/styles/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a style creation status
      effect: read
      questions:
      - Is my style upload still processing, and what styleId did it produce?
      - Where do I poll the long-running style create operation?
      instructions:
      - text: Check the status of style creation operation {operationId}.
        slots:
          operationId: path.operationId
      - text: Poll style job {operationId} and return the new styleId.
        slots:
          operationId: path.operationId
      method: generated
      generated: '2026-09-26'