API Evangelist conversational phrasing for App Store Connect App Tags API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect App Tags API
  version: 1.0.0
extends: openapi/ios-apptags-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: 3
- target: $.paths['/v1/appTags/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Show or hide an App Store tag on my app
      effect: write
      questions:
      - How do I turn off an App Store tag that was assigned to my app?
      - Can I change whether an app tag is visible on my product page?
      instructions:
      - text: Update app tag {tag} with {changes}.
        slots:
          tag: path.id
          changes: requestBody.data
      - text: Hide tag {tag} from my app by setting {changes}.
        slots:
          tag: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appTags/{id}/relationships/territories'].get
  update:
    x-apievangelist-phrasing:
      intent: List territory IDs for an app tag
      effect: read
      questions:
      - Which territory IDs is an app tag applied in?
      - Can I get only the country codes linked to an app tag?
      instructions:
      - text: List only the territory IDs for app tag {tag}.
        slots:
          tag: path.id
      - text: Return up to {limit} territory identifiers for tag {tag}.
        slots:
          limit: query.limit
          tag: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appTags/{id}/territories'].get
  update:
    x-apievangelist-phrasing:
      intent: List the territories where an app tag shows
      effect: read
      questions:
      - In which countries and regions does an App Store tag appear for my app?
      - Can I see the full territory records, with currency, for an app tag?
      instructions:
      - text: Show the full territories where app tag {tag} applies.
        slots:
          tag: path.id
      - text: Fetch territory details and currencies for tag {tag}.
        slots:
          tag: path.id
      method: generated
      generated: '2026-10-01'