# 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 Policy Fragment API
  version: 1.0.0
extends: openapi/microsoft-azure-policyfragment-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}/policyFragments'].get
  update:
    x-apievangelist-phrasing:
      intent: List policy fragments in an APIM workspace
      effect: read
      questions:
      - Which reusable policy fragments are defined in my API Management workspace?
      - Can I filter or sort the policy fragments in a workspace?
      instructions:
      - text: List the policy fragments in workspace {workspace} of API Management service {service}.
        slots:
          workspace: path.workspaceId
          service: path.serviceName
      - text: List workspace policy fragments matching {filter}, ordered by {orderby}.
        slots:
          filter: query.$filter
          orderby: query.$orderby
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policyFragments/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a policy fragment
      effect: read
      questions:
      - How do I read the XML of one policy fragment in an API Management workspace?
      - What does a single workspace policy fragment return?
      instructions:
      - text: Show policy fragment {fragment} in workspace {workspace} on service {service}, with its policy content.
        slots:
          fragment: path.id
          workspace: path.workspaceId
          service: path.serviceName
      - text: Fetch the full definition of workspace policy fragment {fragment}.
        slots:
          fragment: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policyFragments/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a policy fragment
      effect: write
      questions:
      - How do I add a reusable policy fragment to an API Management workspace?
      - Can I overwrite an existing workspace policy fragment with new XML?
      instructions:
      - text: Create policy fragment {fragment} in workspace {workspace} on service {service}.
        slots:
          fragment: path.id
          workspace: path.workspaceId
          service: path.serviceName
      - text: Replace the content of workspace policy fragment {fragment} with my updated policy XML.
        slots:
          fragment: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policyFragments/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a policy fragment
      effect: destructive
      questions:
      - Can I delete a policy fragment from an API Management workspace?
      - What breaks if I remove a fragment that other policies still include?
      instructions:
      - text: Delete policy fragment {fragment} from workspace {workspace} on service {service}.
        slots:
          fragment: path.id
          workspace: path.workspaceId
          service: path.serviceName
      - text: Remove workspace policy fragment {fragment} permanently.
        slots:
          fragment: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policyFragments/{id}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check a policy fragment's ETag
      effect: read
      questions:
      - How do I get just the current ETag version of a policy fragment without its body?
      - Is there a lightweight way to check if a workspace policy fragment exists?
      instructions:
      - text: Check the ETag of policy fragment {fragment} in workspace {workspace}, service {service}.
        slots:
          fragment: path.id
          workspace: path.workspaceId
          service: path.serviceName
      - text: Confirm policy fragment {fragment} exists and report its entity tag version.
        slots:
          fragment: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policyFragments/{id}/listReferences'].post
  update:
    x-apievangelist-phrasing:
      intent: List policies that reference a fragment
      effect: read
      questions:
      - Which policies include a given policy fragment in my workspace?
      - Before deleting a fragment, can I see everywhere it is referenced?
      instructions:
      - text: List the policy resources that reference fragment {fragment} in workspace {workspace} on service {service}.
        slots:
          fragment: path.id
          workspace: path.workspaceId
          service: path.serviceName
      - text: Show every policy that includes workspace policy fragment {fragment}.
        slots:
          fragment: path.id
      method: generated
      generated: '2026-10-01'