API Evangelist conversational phrasing for Blnk Balances API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Blnk Balances API
  version: 1.0.0
extends: openapi/blnkfinance-balances-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['/balances'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a new balance in a ledger
      effect: write
      questions:
      - How do I create a wallet balance in a specific currency inside a ledger?
      - Can one ledger hold balances in different currencies?
      instructions:
      - text: Create a {currency} balance in ledger {ledger_id}.
        slots:
          currency: requestBody.currency
          ledger_id: requestBody.ledger_id
      - text: Open a new balance under ledger {ledger_id} denominated in {currency}.
        slots:
          ledger_id: requestBody.ledger_id
          currency: requestBody.currency
      method: generated
      generated: '2026-10-01'
- target: $.paths['/balances/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a balance's current amount
      effect: read
      questions:
      - What is the current amount sitting in a given balance?
      - Can I fetch a balance together with related data such as its ledger or identity?
      instructions:
      - text: Show me balance {id}.
        slots:
          id: path.id
      - text: Get balance {id} including {include}.
        slots:
          id: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'