# 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 Advanced Rules API
  version: 1.0.0
extends: openapi/avalara-advancedrules-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/advancedrules/accounts/{accountId}/companies/{companyId}/lookupFiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List a company's advanced rules lookup files
      effect: read
      questions:
      - Which lookup files does a company use for advanced rules?
      - Can I see all advanced rules lookup files for one company?
      instructions:
      - text: List lookup files for company {companyId} in account {accountId}.
        slots:
          companyId: path.companyId
          accountId: path.accountId
      - text: Show advanced rules lookup files of company {companyId}, account {accountId}.
        slots:
          companyId: path.companyId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/advancedrules/accounts/{accountId}/companies/{companyId}/lookupFiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an advanced rules lookup file
      effect: write
      questions:
      - How do I add a new lookup file for advanced rules?
      - Can I upload a lookup table for a company's custom tax rules?
      instructions:
      - text: Create a lookup file for company {companyId} in account {accountId}.
        slots:
          companyId: path.companyId
          accountId: path.accountId
      - text: Add a new advanced rules lookup table to company {companyId} under account {accountId}.
        slots:
          companyId: path.companyId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/advancedrules/accounts/{accountId}/lookupFiles/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one advanced rules lookup file
      effect: read
      questions:
      - Can I view a single lookup file by its ID?
      - What does a particular advanced rules lookup file contain?
      instructions:
      - text: Get lookup file {id} in account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      - text: Show the contents of lookup file {id} for account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/advancedrules/accounts/{accountId}/lookupFiles/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an advanced rules lookup file
      effect: write
      questions:
      - How do I change the rows in an existing lookup file?
      - Can I replace a lookup file that advanced rules already reference?
      instructions:
      - text: Update lookup file {id} in account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      - text: Replace the data in existing lookup file {id} for account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/advancedrules/accounts/{accountId}/lookupFiles/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an advanced rules lookup file
      effect: destructive
      questions:
      - How do I remove a lookup file I no longer need?
      - Can I delete an advanced rules lookup file from an account?
      instructions:
      - text: Delete lookup file {id} from account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      - text: Remove advanced rules lookup file {id} in account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'