API Evangelist conversational phrasing for Avalara AvaTax Tax Content API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara AvaTax Tax Content API
  version: 1.0.0
extends: openapi/avalara-taxcontent-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['/api/v2/pointofsaledata/build'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a point-of-sale tax content file
      effect: write
      questions:
      - How do I generate a tax content file for my retail point-of-sale system?
      - Can I build offline tax rate data for a list of locations and items?
      - Why should a POS tax content file be refreshed every day?
      instructions:
      - text: Build a point-of-sale tax content file for my locations.
      - text: Generate fresh tax content data for my retail registers.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/companies/{companyId}/locations/{id}/pointofsaledata'].get
  update:
    x-apievangelist-phrasing:
      intent: Build a tax content file for one store location
      effect: read
      questions:
      - Can I download point-of-sale tax data for just one store location?
      - What tax content does a single retail location need for offline selling?
      instructions:
      - text: Build the point-of-sale tax content file for location {id} of company {companyId}.
        slots:
          id: path.id
          companyId: path.companyId
      - text: Get offline tax data for store location {id} in company {companyId}.
        slots:
          id: path.id
          companyId: path.companyId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/taxratesbyzipcode/download/{date}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download US ZIP code tax rates as CSV
      effect: read
      questions:
      - Where can I get a CSV of sales tax rates for every US five-digit ZIP code?
      - Can I download the ZIP code rate table as of a specific date?
      instructions:
      - text: Download the ZIP code tax rate CSV for {date}.
        slots:
          date: path.date
      - text: Get every US ZIP code's sales and use tax rate effective {date}.
        slots:
          date: path.date
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/taxrates/byaddress'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up free tax rates by street address
      effect: read
      questions:
      - What is the combined sales tax rate at a specific street address?
      - Can I get an estimated tax rate for an address without a paid account?
      instructions:
      - text: Get the estimated combined sales tax rate for a street address.
      - text: Look up the free retail tax rate at a US street address.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/taxrates/bypostalcode'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up free tax rates by postal code
      effect: read
      questions:
      - What is the estimated sales tax rate for a ZIP code?
      - Can I get a tax rate from just a postal code and country?
      instructions:
      - text: Get the estimated combined sales tax rate for a US postal code.
      - text: Look up the free retail tax rate for a ZIP code.
      method: generated
      generated: '2026-10-01'