# 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 Feature State Service Feature…
  version: 1.0.0
extends: openapi/microsoft-azure-featurestatesets-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: 8
- target: $.paths['/featureStateSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List indoor map feature statesets
      effect: read
      questions:
      - Which feature statesets exist in my Azure Maps Creator account?
      - Can I see all the statesets I use for dynamic indoor map styling?
      instructions:
      - text: List all feature statesets in my Creator account.
      - text: Show every stateset I have for indoor maps using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a feature stateset for a dataset
      effect: write
      questions:
      - How do I create a stateset so I can color indoor rooms by occupancy or temperature?
      - Can I define the style rules of a new stateset when I create it?
      instructions:
      - text: Create a feature stateset for dataset {datasetId}.
        slots:
          datasetId: query.datasetId
      - text: Create a stateset on dataset {datasetId} described as {description} with styles {styles}.
        slots:
          datasetId: query.datasetId
          description: query.description
          styles: requestBody.styles
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets/{statesetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a feature stateset's details
      effect: read
      questions:
      - How do I view the style rules of one stateset?
      - Which dataset is a given feature stateset linked to?
      instructions:
      - text: Get stateset {statesetId}.
        slots:
          statesetId: path.statesetId
      - text: Show the styles and dataset of stateset {statesetId}.
        slots:
          statesetId: path.statesetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets/{statesetId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a stateset's style rules
      effect: write
      questions:
      - Can I change the style rules of an existing stateset?
      - How do I replace the color thresholds used by a stateset?
      instructions:
      - text: Update the styles of stateset {statesetId} to {styles}.
        slots:
          statesetId: path.statesetId
          styles: requestBody.styles
      - text: Replace the style rules on stateset {statesetId}.
        slots:
          statesetId: path.statesetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets/{statesetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature stateset
      effect: destructive
      questions:
      - How do I delete a stateset I no longer need?
      - Can I remove an entire stateset along with its feature states?
      instructions:
      - text: Delete stateset {statesetId}.
        slots:
          statesetId: path.statesetId
      - text: Remove the whole feature stateset {statesetId}.
        slots:
          statesetId: path.statesetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets/{statesetId}/featureStates/{featureId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current states of a map feature
      effect: read
      questions:
      - What is the current state value, like occupancy, of a specific room on my indoor map?
      - Can I read the state of one feature within a stateset?
      instructions:
      - text: Get the states of feature {featureId} in stateset {statesetId}.
        slots:
          featureId: path.featureId
          statesetId: path.statesetId
      - text: Show current state values for room {featureId} in {statesetId}.
        slots:
          featureId: path.featureId
          statesetId: path.statesetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets/{statesetId}/featureStates/{featureId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the states of a map feature
      effect: write
      questions:
      - How do I push a new sensor reading so an indoor map room changes color?
      - Can I set several state values on one feature at once?
      instructions:
      - text: Set the states of feature {featureId} in stateset {statesetId} to {states}.
        slots:
          featureId: path.featureId
          statesetId: path.statesetId
          states: requestBody.states
      - text: Update room {featureId}'s state values in {statesetId}.
        slots:
          featureId: path.featureId
          statesetId: path.statesetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/featureStateSets/{statesetId}/featureStates/{featureId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a state value from a map feature
      effect: destructive
      questions:
      - How do I clear one state key, like temperature, from a feature?
      - Can I remove a single state from a room without deleting the whole stateset?
      instructions:
      - text: Delete state {stateKeyName} from feature {featureId} in stateset {statesetId}.
        slots:
          stateKeyName: query.stateKeyName
          featureId: path.featureId
          statesetId: path.statesetId
      - text: Clear the {stateKeyName} value on room {featureId} in {statesetId}.
        slots:
          stateKeyName: query.stateKeyName
          featureId: path.featureId
          statesetId: path.statesetId
      method: generated
      generated: '2026-09-26'