API Evangelist conversational phrasing for Token Member API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Token Member API
  version: 1.0.0
extends: openapi/token-io-member-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/member/product/restrictions'].get
  update:
    x-apievangelist-phrasing:
      intent: List product restrictions on members
      effect: read
      questions:
      - Which product restrictions have I set on members?
      - Can I filter restrictions to the ones targeting a particular member?
      instructions:
      - text: List all my product restrictions.
      - text: Show restrictions that target member {target_member_id}.
        slots:
          target_member_id: query.filter.byTargetMemberId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a product restriction for a member
      effect: write
      questions:
      - Can I restrict what a member is allowed to do with a product?
      - What goes into a new restriction payload?
      instructions:
      - text: Create a restriction on member {target_member_id} with payload {payload}.
        slots:
          target_member_id: requestBody.targetMemberId
          payload: requestBody.restrictionPayload
      - text: Add a product restriction {payload}.
        slots:
          payload: requestBody.restrictionPayload
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/countries'].get
  update:
    x-apievangelist-phrasing:
      intent: List countries available for restrictions
      effect: read
      questions:
      - Which countries can I use when writing a restriction rule?
      - Is there a list of countries supported for product restrictions?
      instructions:
      - text: List the countries I can restrict by.
      - text: Show every country available for restriction rules.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/countries/{countryCode}/regions'].get
  update:
    x-apievangelist-phrasing:
      intent: List regions of a country for restrictions
      effect: read
      questions:
      - What regions within a country can a restriction rule target?
      - Can I get the sub-regions for a specific country code?
      instructions:
      - text: List the restriction regions in country {country_code}.
        slots:
          country_code: path.countryCode
      - text: Show regions I can target inside {country_code}.
        slots:
          country_code: path.countryCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/{restrictionId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a product restriction
      effect: write
      questions:
      - Can I change an existing restriction without deleting it?
      - What happens when I replace a restriction's settings?
      instructions:
      - text: Update restriction {restriction_id} to {updated}.
        slots:
          restriction_id: path.restrictionId
          updated: requestBody.updatedRestriction
      - text: Change the settings of restriction {restriction_id}.
        slots:
          restriction_id: path.restrictionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/{restrictionId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product restriction
      effect: destructive
      questions:
      - Can I lift a restriction entirely by removing it?
      - Does deleting a restriction remove its rules too?
      instructions:
      - text: Delete restriction {restriction_id}.
        slots:
          restriction_id: path.restrictionId
      - text: Lift product restriction {restriction_id}.
        slots:
          restriction_id: path.restrictionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/{restrictionId}/rule'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a rule to a product restriction
      effect: write
      questions:
      - How do I add a new rule under an existing restriction?
      - Can one restriction have several rules?
      instructions:
      - text: Add rule {rule} to restriction {restriction_id}.
        slots:
          rule: requestBody.rule
          restriction_id: path.restrictionId
      - text: Create a new rule under restriction {restriction_id}.
        slots:
          restriction_id: path.restrictionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/{restrictionId}/rules/{ruleId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a rule in a product restriction
      effect: write
      questions:
      - Can I edit one rule inside a restriction?
      - What do I send to change an existing restriction rule?
      instructions:
      - text: Update rule {rule_id} in restriction {restriction_id} to {updated_rule}.
        slots:
          rule_id: path.ruleId
          restriction_id: path.restrictionId
          updated_rule: requestBody.updatedRule
      - text: Edit rule {rule_id} of restriction {restriction_id}.
        slots:
          rule_id: path.ruleId
          restriction_id: path.restrictionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/member/product/restrictions/{restrictionId}/rules/{ruleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a rule from a product restriction
      effect: destructive
      questions:
      - Can I remove a single rule but keep the restriction?
      - What's needed to delete one restriction rule?
      instructions:
      - text: Delete rule {rule_id} from restriction {restriction_id}.
        slots:
          rule_id: path.ruleId
          restriction_id: path.restrictionId
      - text: Remove restriction {restriction_id}'s rule {rule_id}.
        slots:
          restriction_id: path.restrictionId
          rule_id: path.ruleId
      method: generated
      generated: '2026-09-26'