API Evangelist conversational phrasing for Azure API Management REST Tag API

# 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 Tag API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-tag-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: 12
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List tags on the service
      effect: read
      questions:
      - What tags are defined across my API Management service instance?
      - Can I see every service-level tag I use to organize APIs?
      instructions:
      - text: List all tags defined on my API Management service.
      - text: Show me every service-level tag.
      - text: Show the tags available across service {serviceName} for labeling APIs.
        slots:
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a service-level tag
      effect: read
      questions:
      - How do I look up one tag's display name on the service?
      - What does a particular service tag look like?
      instructions:
      - text: Get the service-level tag with the ID I give you.
      - text: Fetch this tag's details from the service.
      - text: Get service-level tag {tagId} from API Management service {serviceName}.
        slots:
          tagId: path.tagId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a service-level tag
      effect: write
      questions:
      - How do I create a new tag on my service for grouping APIs?
      - Can I define a tag at the service level rather than in a workspace?
      instructions:
      - text: Create a service-level tag with the ID I name.
      - text: Add a new tag to the API Management service.
      - text: Create service-level tag {tagId} on API Management service {serviceName}.
        slots:
          tagId: path.tagId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a service-level tag
      effect: destructive
      questions:
      - How can I remove a tag from my API Management service entirely?
      - Is deleting a service tag permanent?
      instructions:
      - text: Delete the service-level tag I name.
      - text: Remove this tag from the service altogether.
      - text: Delete service-level tag {tagId} from service {serviceName} altogether.
        slots:
          tagId: path.tagId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a service-level tag
      effect: write
      questions:
      - Can I change a service tag's display name without recreating it?
      - Is there a way to update an existing tag on the service?
      instructions:
      - text: Update the display name of the service-level tag I name.
      - text: Patch this existing service tag with new details.
      - text: Change the display name of service-level tag {tagId} on {serviceName}.
        slots:
          tagId: path.tagId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a service tag's entity version
      effect: read
      questions:
      - Can I check a service tag's entity version without fetching it?
      - Does a given tag exist on my service?
      instructions:
      - text: Check the entity state version of the service-level tag I name.
      - text: Confirm this tag exists on the service using only its version header.
      - text: Read only the version header of service-level tag {tagId} on {serviceName}.
        slots:
          tagId: path.tagId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List tags in a workspace
      effect: read
      questions:
      - Which tags are defined inside one of my workspaces?
      - Can I list only a single workspace's tags?
      instructions:
      - text: List every tag in the workspace I name.
      - text: Show me my workspace's tags.
      - text: List every tag in workspace {workspaceId} of service {serviceName}.
        slots:
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag in a workspace
      effect: read
      questions:
      - How do I read one tag defined in a workspace?
      - What display name does a workspace tag have?
      instructions:
      - text: Get the workspace tag with the ID I give you.
      - text: Fetch one tag's details from inside my workspace.
      - text: Get tag {tagId} from inside workspace {workspaceId} on {serviceName}.
        slots:
          tagId: path.tagId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a tag in a workspace
      effect: write
      questions:
      - How do I create a tag that belongs to a specific workspace?
      - Can I add tags scoped to a workspace rather than the whole service?
      instructions:
      - text: Create a tag inside the workspace I name.
      - text: Add a new workspace-scoped tag.
      - text: Create tag {tagId} inside workspace {workspaceId} on service {serviceName}.
        slots:
          tagId: path.tagId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag in a workspace
      effect: destructive
      questions:
      - How can I remove a tag from a workspace?
      - Is deleting a workspace tag reversible?
      instructions:
      - text: Delete the workspace tag I name.
      - text: Remove this tag from my workspace.
      - text: Delete tag {tagId} from workspace {workspaceId} on service {serviceName}.
        slots:
          tagId: path.tagId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a tag in a workspace
      effect: write
      questions:
      - Can I change a workspace tag's display name in place?
      - Is it possible to update a tag scoped to a workspace?
      instructions:
      - text: Update the display name of the workspace tag I name.
      - text: Patch this tag inside my workspace.
      - text: Change the display name of tag {tagId} in workspace {workspaceId} on {serviceName}.
        slots:
          tagId: path.tagId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/tags/{tagId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace tag's entity version
      effect: read
      questions:
      - Can I check a workspace tag's entity version without fetching it?
      - Does a given tag exist in my workspace?
      instructions:
      - text: Check the entity state version of the workspace tag I name.
      - text: Confirm this tag exists in my workspace from its version header.
      - text: Read only the version header of workspace tag {tagId} in {workspaceId} on {serviceName}.
        slots:
          tagId: path.tagId
          workspaceId: path.workspaceId
          serviceName: path.serviceName
      method: generated
      generated: '2026-10-01'