# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Avalara Subscriptions API
  version: 1.0.0
extends: openapi/avalara-subscriptions-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: 4
- target: $.paths['/api/v2/accounts/{id}/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an account's subscriptions
      effect: read
      questions:
      - Which services is a given account subscribed to?
      - Can I filter an account's subscriptions?
      instructions:
      - text: List subscriptions for account {id}.
        slots:
          id: path.id
      - text: Show subscriptions of account {id} matching {filter}.
        slots:
          id: path.id
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/accounts/{accountId}/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an account's licensed Avalara services
      effect: read
      questions:
      - What licensed services are attached to an account by its accountId?
      - Which named Avalara services does this account hold a license for?
      instructions:
      - text: List licensed service subscriptions for account {accountId}.
        slots:
          accountId: path.accountId
      - text: Show the subscription objects attached to account {accountId}.
        slots:
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/accounts/{accountId}/subscriptions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one subscription on an account
      effect: read
      questions:
      - Can I look up a single subscription on an account?
      - Is a specific service subscription still active for this account?
      instructions:
      - text: Get subscription {id} on account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      - text: Show details of subscription {id} for account {accountId}.
        slots:
          id: path.id
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: Query subscriptions across all accounts
      effect: read
      questions:
      - Can I search subscriptions across every account I can see?
      - Which accounts are subscribed to a particular service?
      instructions:
      - text: Query subscriptions across all accounts.
      - text: Search every account's service subscriptions.
      method: generated
      generated: '2026-10-01'