# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara Communications Tax Customization API
  version: 1.0.0
extends: openapi/avalara-customization-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: 4
- target: $.paths['/api/v2/afc/customization/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List communications tax profiles
      effect: read
      questions:
      - Which custom tax profiles are configured for my communications tax account?
      - Can I see my tax profiles and their bundles?
      instructions:
      - text: List my tax profiles.
      - text: Show all configured communications tax profiles.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/afc/customization/profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a communications tax profile
      effect: write
      questions:
      - Can I create a tax profile with custom bundles and overrides?
      - Is it possible to define my own bundle of services as a tax profile?
      instructions:
      - text: Create tax profile {profileName} with bundles {bundles}.
        slots:
          profileName: requestBody.profileName
          bundles: requestBody.bundles
      - text: Add a tax profile named {profileName} described as {description}.
        slots:
          profileName: requestBody.profileName
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/afc/customization/exclusions'].get
  update:
    x-apievangelist-phrasing:
      intent: List tax exclusions
      effect: read
      questions:
      - Which tax exclusions have I configured?
      - Can I see the taxes I've excluded by country and state?
      instructions:
      - text: List my tax exclusions.
      - text: Show every configured tax exclusion.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/afc/customization/exclusions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tax exclusion
      effect: write
      questions:
      - Can I exclude a jurisdiction's tax from my communications tax calculations?
      - Is there a way to exclude taxes for a specific state?
      instructions:
      - text: Create a tax exclusion for country {ctry}, state {st}.
        slots:
          ctry: requestBody.ctry
          st: requestBody.st
      - text: Add exclusion {excl_name} for state {st} in {ctry}.
        slots:
          excl_name: requestBody.excl_name
          st: requestBody.st
          ctry: requestBody.ctry
      method: generated
      generated: '2026-09-26'