# 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 ApiManagementClient Named Value API
  version: 1.0.0
extends: openapi/microsoft-azure-namedvalue-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues'].get
  update:
    x-apievangelist-phrasing:
      intent: List named values in an API Management workspace
      effect: read
      questions:
      - Which named values are defined in my API Management workspace?
      - Can I find the named values whose Key Vault refresh has failed?
      instructions:
      - text: List the named values in workspace {workspace} of API Management service {service}.
        slots:
          workspace: path.workspaceId
          service: path.serviceName
      - text: List workspace named values filtered by {filter}.
        slots:
          filter: query.$filter
      - text: Show named values where Key Vault refresh failed is {isKeyVaultRefreshFailed}.
        slots:
          isKeyVaultRefreshFailed: query.isKeyVaultRefreshFailed
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a named value's details
      effect: read
      questions:
      - What display name and tags does a particular workspace named value have?
      - Can I see whether a named value is a secret or backed by Key Vault?
      instructions:
      - text: Get the details of named value {namedValue} in workspace {workspace} of service {service}.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show the configuration of workspace named value {namedValue}.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a workspace named value
      effect: write
      questions:
      - How do I add a named value to an API Management workspace for use in policies?
      - Can I overwrite an existing workspace named value in one call?
      instructions:
      - text: Create named value {namedValue} in workspace {workspace} of API Management service {service}.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Create or replace workspace named value {namedValue} with my new definition.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a workspace named value
      effect: destructive
      questions:
      - How do I remove a named value from my API Management workspace?
      - What happens to policies when I delete a workspace named value?
      instructions:
      - text: Delete named value {namedValue} from workspace {workspace} of API Management service {service}.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Remove workspace named value {namedValue} permanently.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update part of a workspace named value
      effect: write
      questions:
      - Can I change only the value or tags of an existing named value?
      - Is there a partial update for workspace named values?
      instructions:
      - text: Patch existing named value {namedValue} in workspace {workspace} of service {service} with only the fields I changed.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Partially update workspace named value {namedValue} without recreating it.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get the ETag version of a named value
      effect: read
      questions:
      - How do I read the current ETag of a workspace named value before updating it?
      - Can I check a named value's entity version without fetching its contents?
      instructions:
      - text: Get the entity tag of named value {namedValue} in workspace {workspace} of service {service}.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Check the ETag version of workspace named value {namedValue}.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}/listValue'].post
  update:
    x-apievangelist-phrasing:
      intent: Reveal a named value's secret
      effect: read
      questions:
      - How do I see the actual secret stored in a workspace named value?
      - Why is a secret named value hidden in normal reads, and how do I retrieve it?
      instructions:
      - text: Reveal the secret value of named value {namedValue} in workspace {workspace} of service {service}.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show me the plaintext secret behind named value {namedValue}.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues/{namedValueId}/refreshSecret'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a named value's secret from Key Vault
      effect: write
      questions:
      - How do I force a Key Vault-backed named value to pick up a rotated secret?
      - Can I refresh a named value secret after its Key Vault refresh failed?
      instructions:
      - text: Refresh the Key Vault secret of named value {namedValue} in workspace {workspace} of service {service}.
        slots:
          namedValue: path.namedValueId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Re-pull the Key Vault secret for named value {namedValue} now.
        slots:
          namedValue: path.namedValueId
      method: generated
      generated: '2026-10-01'