# 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 Verification Sessions API
  version: 1.0.0
extends: openapi/methodfi-account-verification-sessions-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: 5
- target: $.paths['/accounts/{accountId}/verification_sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List verification sessions for an account
      effect: read
      questions:
      - Which verification attempts have been made on this account?
      - Can I page through all verification sessions for an account?
      instructions:
      - text: List verification sessions for account {account}.
        slots:
          account: path.accountId
      - text: Show the verification attempts on account {account}.
        slots:
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/verification_sessions'].post
  update:
    x-apievangelist-phrasing:
      intent: Start verifying an account
      effect: write
      questions:
      - How do I begin verifying ownership of a bank account?
      - What verification types can a new account session use?
      instructions:
      - text: Start a {type} verification session for account {account}.
        slots:
          type: requestBody.type
          account: path.accountId
      - text: Open a verification session on account {account} using {type}.
        slots:
          account: path.accountId
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/verification_sessions/{avfId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one account verification session
      effect: read
      questions:
      - Has a particular account verification session succeeded?
      - Can I look up a verification session by its ID?
      instructions:
      - text: Get verification session {session} on account {account}.
        slots:
          session: path.avfId
          account: path.accountId
      - text: Check whether verification session {session} for account {account} passed.
        slots:
          session: path.avfId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/verification_sessions/{avfId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Submit details to verify an account
      effect: write
      questions:
      - How do I submit micro-deposit amounts to finish verifying an account?
      - Can I complete a verification session with aggregator data instead?
      instructions:
      - text: Submit micro-deposit amounts {micro_deposits} to session {session} on account {account}.
        slots:
          micro_deposits: requestBody.micro_deposits
          session: path.avfId
          account: path.accountId
      - text: Complete verification session {session} for account {account} with instant data {instant}.
        slots:
          session: path.avfId
          account: path.accountId
          instant: requestBody.instant
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/verification_sessions/{avfId}/amounts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get micro-deposit amounts for a session
      effect: read
      questions:
      - Where can I see the micro-deposit amounts sent for a verification session?
      - Can I retrieve the deposit amounts used to verify an account?
      instructions:
      - text: Get the micro-deposit amounts for session {session} on account {account}.
        slots:
          session: path.avfId
          account: path.accountId
      - text: Show the deposit amounts sent for verification {session} of account {account}.
        slots:
          session: path.avfId
          account: path.accountId
      method: generated
      generated: '2026-10-01'