# 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 Policy Fragment API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/policyFragments'].get
  update:
    x-apievangelist-phrasing:
      intent: List policy fragments in a workspace
      effect: read
      questions:
      - Which reusable policy fragments are defined in one of my workspaces?
      - Can I see all the policy snippets my workspace policies can include?
      instructions:
      - text: List every policy fragment in workspace {workspaceId} on service {serviceName}.
        slots:
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Show me the workspace's policy fragments.
      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?
      - What does a particular reusable policy fragment in my workspace contain?
      instructions:
      - text: Get policy fragment {id} from workspace {workspaceId} on service {serviceName}.
        slots:
          id: path.id
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Show me the content of one workspace policy fragment.
      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 replace a policy fragment
      effect: write
      questions:
      - How do I create a reusable policy fragment in API Management?
      - Can I overwrite an existing policy fragment's content?
      instructions:
      - text: Create policy fragment {id} in workspace {workspaceId} on service {serviceName}.
        slots:
          id: path.id
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Replace the content of this workspace policy fragment.
      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:
      - How can I remove a policy fragment from a workspace?
      - Is deleting a policy fragment permanent?
      instructions:
      - text: Delete policy fragment {id} from workspace {workspaceId} on service {serviceName}.
        slots:
          id: path.id
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Remove this reusable policy fragment.
      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: Get a policy fragment's ETag
      effect: read
      questions:
      - Can I read a policy fragment's ETag before editing it?
      - Does a policy fragment with a given ID exist in my workspace?
      instructions:
      - text: Check the ETag of policy fragment {id} in workspace {workspaceId} on service {serviceName}.
        slots:
          id: path.id
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      - text: Confirm this policy fragment exists from its entity state header.
      method: generated
      generated: '2026-10-01'