# 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 Payment Instruments API
  version: 1.0.0
extends: openapi/methodfi-account-payment-instruments-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['/accounts/{accountId}/payment_instruments'].get
  update:
    x-apievangelist-phrasing:
      intent: List payment instruments on an account
      effect: read
      questions:
      - Which payment instruments are attached to this account?
      - Can I page through all the payment instruments issued for an account?
      instructions:
      - text: List payment instruments for account {account}.
        slots:
          account: path.accountId
      - text: Show {page_limit} payment instruments per page for account {account}.
        slots:
          account: path.accountId
          page_limit: query.page_limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/payment_instruments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a payment instrument for an account
      effect: write
      questions:
      - How do I create a new payment instrument for an account?
      - What types of payment instrument can be issued against an account?
      instructions:
      - text: Create a {type} payment instrument for account {account}.
        slots:
          type: requestBody.type
          account: path.accountId
      - text: Issue a new payment instrument on account {account} of type {type}.
        slots:
          account: path.accountId
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/payment_instruments/{pmtInsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one payment instrument
      effect: read
      questions:
      - Can I look up a payment instrument's details by its ID?
      - What's the current status of a specific payment instrument?
      instructions:
      - text: Get payment instrument {instrument} on account {account}.
        slots:
          instrument: path.pmtInsId
          account: path.accountId
      - text: Show details of payment instrument {instrument} for account {account}.
        slots:
          instrument: path.pmtInsId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/payment_instruments/{pmtInsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Close a payment instrument
      effect: destructive
      questions:
      - How do I close a payment instrument I no longer need?
      - Is closing a payment instrument only possible on API version 2025-12-01 or later?
      instructions:
      - text: Close payment instrument {instrument} on account {account}.
        slots:
          instrument: path.pmtInsId
          account: path.accountId
      - text: Shut down payment instrument {instrument} for account {account} so it can't be used.
        slots:
          instrument: path.pmtInsId
          account: path.accountId
      method: generated
      generated: '2026-10-01'