# 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 Workspace Policy API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-workspacepolicy-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List a workspace's policies
      effect: read
      questions:
      - What policy configuration is applied at the workspace level?
      - Can I list all policies set on one of my workspaces?
      instructions:
      - text: List the policies configured on workspace {workspaceId} in service {serviceName}.
        slots:
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Show me all workspace-level policy configuration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policies/{policyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace policy
      effect: read
      questions:
      - How do I read the XML of one specific workspace policy?
      - What rules does a particular policy on my workspace enforce?
      instructions:
      - text: Get policy {policyId} from workspace {workspaceId} in service {serviceName}.
        slots:
          policyId: path.policyId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Show me the content of one workspace policy by its ID.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policies/{policyId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a workspace's policy
      effect: write
      questions:
      - How do I apply a policy to every API in a workspace?
      - Can I overwrite the workspace-level policy in one request?
      instructions:
      - text: Set policy {policyId} on workspace {workspaceId} in service {serviceName}.
        slots:
          policyId: path.policyId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Replace this workspace's policy configuration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policies/{policyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a workspace's policy
      effect: destructive
      questions:
      - How can I remove the policy configuration from a workspace?
      - Is deleting a workspace policy permanent?
      instructions:
      - text: Delete policy {policyId} from workspace {workspaceId} in service {serviceName}.
        slots:
          policyId: path.policyId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Clear this workspace's policy configuration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policies/{policyId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace policy's ETag
      effect: read
      questions:
      - Can I read a workspace policy's ETag before changing it?
      - Does a policy with a given ID exist on my workspace?
      instructions:
      - text: Check the ETag of policy {policyId} on workspace {workspaceId} in service {serviceName}.
        slots:
          policyId: path.policyId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Confirm this workspace policy exists from its entity state header.
      method: generated
      generated: '2026-10-01'