# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for PSA Taxes API
  version: 1.0.0
extends: openapi/acronis-taxes-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['/Taxes'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tax rate
      effect: read
      questions:
      - How do I look up a tax rate by its ID?
      - What value and code does a given tax have?
      instructions:
      - text: Show tax {id}.
        slots:
          id: query.id
      - text: Get the tax rate with ID {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Taxes'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or save a single tax
      effect: write
      questions:
      - How do I add a new tax rate to my billing setup?
      - Can I make a single tax the default one?
      instructions:
      - text: Create a tax named {Name} at {Value}.
        slots:
          Name: requestBody.Name
          Value: requestBody.Value
      - text: Save tax {Name} with code {Code} as the default.
        slots:
          Name: requestBody.Name
          Code: requestBody.Code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Taxes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create taxes from a tax object
      effect: write
      questions:
      - Is there a POST endpoint for submitting tax definitions?
      - Can I create taxes by posting a Tax object?
      instructions:
      - text: Post tax definition {Tax}.
        slots:
          Tax: requestBody.Tax
      - text: Create taxes from the Tax object {Tax}.
        slots:
          Tax: requestBody.Tax
      method: generated
      generated: '2026-09-26'
- target: $.paths['/Taxes'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tax
      effect: destructive
      questions:
      - How do I remove a tax rate I no longer charge?
      - Can I delete a tax by ID?
      instructions:
      - text: Delete tax {id}.
        slots:
          id: query.id
      - text: Remove the tax rate {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'