# 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 Key Values API
  version: 1.0.0
extends: openapi/microsoft-azure-keyvalues-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/keyValues'].get
  update:
    x-apievangelist-phrasing:
      intent: List key-values of a configuration store (ARM)
      effect: read
      questions:
      - Can I list an App Configuration store's key-values through Azure Resource Manager instead of the store endpoint?
      - Which key-values does a configuration store hold, seen as ARM resources?
      instructions:
      - text: List key-values of configuration store {store} in resource group {resource_group}, subscription {subscription_id} via ARM.
        slots:
          store: path.configStoreName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Continue listing ARM key-values for store {store} from skip token {skip_token}.
        slots:
          store: path.configStoreName
          skip_token: query.$skipToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/keyValues/{keyValueName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a key-value resource via ARM
      effect: read
      questions:
      - How do I read one key-value's properties as a management-plane resource?
      - Can I fetch a configuration setting by its ARM key-value name?
      instructions:
      - text: Get ARM key-value {key_value_name} from configuration store {store} in {resource_group}, subscription {subscription_id}.
        slots:
          key_value_name: path.keyValueName
          store: path.configStoreName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Show the management-plane properties of key-value {key_value_name} in store {store}.
        slots:
          key_value_name: path.keyValueName
          store: path.configStoreName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/keyValues/{keyValueName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a key-value via ARM
      effect: write
      questions:
      - Can I create an App Configuration setting through Resource Manager, for example from a template?
      - How do I set a key-value as an ARM resource under a configuration store?
      instructions:
      - text: Create ARM key-value {key_value_name} in store {store}, resource group {resource_group}, subscription {subscription_id} with properties {properties}.
        slots:
          key_value_name: path.keyValueName
          store: path.configStoreName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
          properties: requestBody.properties
      - text: Add the management-plane key-value {key_value_name} to configuration store {store}.
        slots:
          key_value_name: path.keyValueName
          store: path.configStoreName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/keyValues/{keyValueName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a key-value via ARM
      effect: destructive
      questions:
      - How do I delete an App Configuration key-value through Resource Manager?
      - Can I remove a setting from a store using the management plane?
      instructions:
      - text: Delete ARM key-value {key_value_name} from store {store} in {resource_group}, subscription {subscription_id}.
        slots:
          key_value_name: path.keyValueName
          store: path.configStoreName
          resource_group: path.resourceGroupName
          subscription_id: path.subscriptionId
      - text: Remove key-value resource {key_value_name} from configuration store {store}.
        slots:
          key_value_name: path.keyValueName
          store: path.configStoreName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kv'].get
  update:
    x-apievangelist-phrasing:
      intent: List configuration settings from a store
      effect: read
      questions:
      - How do I read all the settings in my App Configuration store that match a key prefix?
      - Can I pull the settings as they were at a point in time, or from a snapshot?
      - Which settings have a particular label?
      instructions:
      - text: List configuration settings whose key matches {key}.
        slots:
          key: query.key
      - text: Get all settings with label {label} as they were at {accept_datetime}.
        slots:
          label: query.label
          accept_datetime: header.Accept-Datetime
      - text: Read the key-values stored in snapshot {snapshot}.
        slots:
          snapshot: query.snapshot
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kv'].head
  update:
    x-apievangelist-phrasing:
      intent: Check headers for a set of settings
      effect: read
      questions:
      - Can I check whether any settings match a key filter without downloading them?
      - Is there a lightweight HEAD request to test if a filtered set of settings changed?
      instructions:
      - text: Check the headers for settings matching {key} without fetching bodies.
        slots:
          key: query.key
      - text: Probe whether settings labelled {label} exist using a HEAD request.
        slots:
          label: query.label
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kv/{key}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a single configuration setting
      effect: read
      questions:
      - How do I read the value of one configuration setting by its key?
      - Can I fetch a setting only if it has changed since my cached ETag?
      instructions:
      - text: Get the value of setting {key}.
        slots:
          key: path.key
      - text: Read setting {key} with label {label}.
        slots:
          key: path.key
          label: query.label
      - text: Fetch setting {key} only if it no longer matches ETag {etag}.
        slots:
          key: path.key
          etag: header.If-None-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kv/{key}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a configuration setting
      effect: write
      questions:
      - How do I write a new setting value into my App Configuration store?
      - Can I set a content type and tags on a setting while saving it?
      instructions:
      - text: Set setting {key} to {value}.
        slots:
          key: path.key
          value: requestBody.value
      - text: Save setting {key} with label {label} and value {value}.
        slots:
          key: path.key
          label: query.label
          value: requestBody.value
      - text: Store {value} under {key} with content type {content_type}.
        slots:
          value: requestBody.value
          key: path.key
          content_type: requestBody.content_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kv/{key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a configuration setting
      effect: destructive
      questions:
      - How do I delete one setting from my configuration store?
      - Can I delete a setting only if nobody changed it since I read it?
      instructions:
      - text: Delete setting {key}.
        slots:
          key: path.key
      - text: Delete setting {key} with label {label} only if its ETag is {etag}.
        slots:
          key: path.key
          label: query.label
          etag: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kv/{key}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check whether a single setting exists
      effect: read
      questions:
      - Can I test if a specific setting key exists without reading its value?
      - How do I get just the ETag of one setting to see if it changed?
      instructions:
      - text: Check if setting {key} exists using a HEAD request.
        slots:
          key: path.key
      - text: Get only the headers for setting {key} under label {label}.
        slots:
          key: path.key
          label: query.label
      method: generated
      generated: '2026-09-26'