# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Method Account Payoffs API
  version: 1.0.0
extends: openapi/methodfi-account-payoffs-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: 3
- target: $.paths['/accounts/{accountId}/payoffs'].get
  update:
    x-apievangelist-phrasing:
      intent: List payoff records for an account
      effect: read
      questions:
      - Where can I see every payoff quote pulled for a loan account?
      - Can I page through the payoff history on an account?
      instructions:
      - text: List payoff records for account {account}.
        slots:
          account: path.accountId
      - text: Show the payoff quote history for account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/payoffs'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a new payoff amount for an account
      effect: write
      questions:
      - How do I get an up-to-date payoff amount for a loan?
      - Can I trigger a fresh payoff sync on a liability account?
      instructions:
      - text: Request a new payoff quote for account {account}.
        slots:
          account: path.accountId
      - text: Sync the payoff amount for account {account} with idempotency key {key}.
        slots:
          account: path.accountId
          key: header.Idempotency-Key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/payoffs/{pyfId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one payoff record
      effect: read
      questions:
      - What payoff amount did a specific payoff sync return?
      - Can I fetch a payoff record by its ID?
      instructions:
      - text: Get payoff record {payoff} for account {account}.
        slots:
          payoff: path.pyfId
          account: path.accountId
      - text: Show the payoff quote {payoff} on account {account}.
        slots:
          payoff: path.pyfId
          account: path.accountId
      method: generated
      generated: '2026-10-01'