# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Stripe Tax Tax Codes API
  version: 1.0.0
extends: openapi/stripe-tax-codes-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: 2
- target: $.paths['/v1/tax_codes'].get
  update:
    x-apievangelist-phrasing:
      intent: List product tax codes
      effect: read
      questions:
      - Which tax codes can I assign to my products?
      - How do I find the right tax category for a digital product?
      instructions:
      - text: List all available tax codes.
      - text: Show the next {limit} tax codes after {starting_after}.
        slots:
          limit: query.limit
          starting_after: query.starting_after
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/tax_codes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a tax code
      effect: read
      questions:
      - How do I see what a specific tax code covers?
      - Can I look up the description of a tax code by its ID?
      instructions:
      - text: Get tax code {id}.
        slots:
          id: path.id
      - text: Explain what tax code {id} applies to.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'