# 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 Updates API
  version: 1.0.0
extends: openapi/methodfi-account-updates-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}/updates'].get
  update:
    x-apievangelist-phrasing:
      intent: List update records for an account
      effect: read
      questions:
      - Where can I see each time an account's details were refreshed?
      - Can I page through all update records on one account?
      instructions:
      - text: List update records for account {account}.
        slots:
          account: path.accountId
      - text: Show the refresh history for account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/updates'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a refresh of account details
      effect: write
      questions:
      - How do I ask Method to refresh an account's details on demand?
      - Can I trigger a new update request for a liability account?
      instructions:
      - text: Request an update for account {account}.
        slots:
          account: path.accountId
      - text: Refresh the details of account {account} now.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/updates/{updateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one account update
      effect: read
      questions:
      - What did a specific account update return?
      - Can I check whether an update request has completed?
      instructions:
      - text: Get update {update} on account {account}.
        slots:
          update: path.updateId
          account: path.accountId
      - text: Check the status of update request {update} for account {account}.
        slots:
          update: path.updateId
          account: path.accountId
      method: generated
      generated: '2026-10-01'