# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ROI360 Net Revenue API (v2.0) Tax rate rules API
  version: 1.0.0
extends: openapi/appsflyer-tax-rate-rules-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: 2
- target: $.paths['/tax_rates/app/{app_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an app's tax rate catalog
      effect: read
      questions:
      - Which tax rates apply to my app's revenue in a given country?
      - Can I filter the tax catalog by postal code or subdivision?
      - Can I download the tax catalog as CSV?
      instructions:
      - text: Get the tax catalog for app {app}.
        slots:
          app: path.app_id
      - text: List taxes for {app} in country {country} at rate {rate}.
        slots:
          app: path.app_id
          country: query.country
          rate: query.tax_rate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tax_rates/app/{app_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create custom tax rate rules for an app
      effect: write
      questions:
      - How do I set my own tax rate for an app in a specific country?
      - Will default tax updates still apply after I set a custom rate?
      instructions:
      - text: Create tax rate rules {taxes} for app {app}.
        slots:
          taxes: requestBody.taxes
          app: path.app_id
      - text: Add a custom tax rule to {app}.
        slots:
          app: path.app_id
      method: generated
      generated: '2026-10-01'