# 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 Workspace Policy API
  version: 1.0.0
extends: openapi/microsoft-azure-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 API Management workspace policies
      effect: read
      questions:
      - What policies are applied at the workspace level in API Management?
      - How do I see the policy configuration of an APIM workspace?
      instructions:
      - text: List the policies on workspace {workspace} of API Management service {service}.
        slots:
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show every workspace-level policy in this APIM workspace.
      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 an API Management workspace policy
      effect: read
      questions:
      - Can I read the XML of one workspace policy in API Management?
      - What does the current workspace policy definition contain?
      instructions:
      - text: Read workspace policy {policy} for workspace {workspace} on APIM service {service}.
        slots:
          policy: path.policyId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show the full policy document configured on this workspace.
      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: Create or update an API Management workspace policy
      effect: write
      questions:
      - How do I apply rate limiting to every API in an APIM workspace?
      - Can I replace a workspace policy with new XML?
      instructions:
      - text: Set workspace policy {policy} on workspace {workspace} of service {service}, replacing the old XML.
        slots:
          policy: path.policyId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Replace this workspace's policy document with my new version.
      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: Delete an API Management workspace policy
      effect: destructive
      questions:
      - Can I remove the policy configured at an APIM workspace?
      - What happens to APIs in a workspace once its policy is deleted?
      instructions:
      - text: Delete workspace policy {policy} from workspace {workspace} on API Management service {service}.
        slots:
          policy: path.policyId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Remove the 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}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace policy's ETag
      effect: read
      questions:
      - How do I get the current ETag of a workspace policy before updating it?
      - Can I check if a workspace policy exists without downloading it?
      instructions:
      - text: Fetch only the entity tag of policy {policy} in workspace {workspace}, service {service}.
        slots:
          policy: path.policyId
          workspace: path.workspaceId
          service: path.serviceName
      - text: Check the ETag version of this APIM workspace policy.
      method: generated
      generated: '2026-10-01'