# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Azure API Management REST Named Value API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/namedValues'].get
  update:
    x-apievangelist-phrasing:
      intent: List named values in a workspace
      effect: read
      questions:
      - Which named values are defined in one of my API Management workspaces?
      - Can I see all the reusable policy variables for a workspace?
      instructions:
      - text: List every named value in workspace {workspaceId} of my {serviceName} service.
        slots:
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Show me the workspace's named values.
      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 in a workspace
      effect: read
      questions:
      - How do I look up one named value's settings in a workspace?
      - Is a particular named value marked as secret?
      instructions:
      - text: Get the details of named value {namedValueId} in workspace {workspaceId} on {serviceName}.
        slots:
          namedValueId: path.namedValueId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Show me the details of one workspace named value.
      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 replace a named value
      effect: write
      questions:
      - How do I add a named value my workspace policies can reference?
      - Can I overwrite a workspace named value in one request?
      instructions:
      - text: Create or replace named value {namedValueId} in workspace {workspaceId} on {serviceName}.
        slots:
          namedValueId: path.namedValueId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Create or fully replace this workspace named value.
      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 named value from a workspace
      effect: destructive
      questions:
      - How can I remove a named value from a workspace?
      - Is deleting a workspace named value permanent?
      instructions:
      - text: Delete named value {namedValueId} from workspace {workspaceId} in service {serviceName}.
        slots:
          namedValueId: path.namedValueId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Remove this named value from the workspace.
      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 a named value in a workspace
      effect: write
      questions:
      - Can I change a named value's contents without recreating it?
      - Is there a way to patch an existing workspace named value?
      instructions:
      - text: Change the value of existing named value {namedValueId} in workspace {workspaceId} on {serviceName}.
        slots:
          namedValueId: path.namedValueId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Change the value of a workspace named value that already exists.
      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 a named value's ETag
      effect: read
      questions:
      - Can I read a workspace named value's ETag before updating it?
      - Does a named value with a given ID exist in my workspace?
      instructions:
      - text: Check the ETag of named value {namedValueId} in workspace {workspaceId} on service {serviceName}.
        slots:
          namedValueId: path.namedValueId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Confirm this workspace named value exists from its entity state header.
      method: generated
      generated: '2026-10-01'