API Evangelist conversational phrasing for Mx Technologies Microdeposits API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mx Technologies Microdeposits API
  version: 1.0.0
extends: openapi/mx-technologies-microdeposits-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/users/{user_guid}/micro_deposits'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's microdeposits
      effect: read
      questions:
      - Which microdeposit verifications has a user started?
      - What is the status of all the small test deposits sent for a user?
      instructions:
      - text: List microdeposits for user {user}.
        slots:
          user: path.user_guid
      - text: Show every microdeposit and its status for user {user}.
        slots:
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/micro_deposits'].post
  update:
    x-apievangelist-phrasing:
      intent: Start or pre-initiate a microdeposit
      effect: write
      questions:
      - How do I verify a bank account with small test deposits when instant verification isn't available?
      - Can I pre-fill a user's name and email before they reach the microdeposit flow?
      instructions:
      - text: Create a microdeposit for user {user} with {details}.
        slots:
          user: path.user_guid
          details: requestBody.micro_deposit
      - text: Pre-initiate a microdeposit for user {user} using name and email {details}.
        slots:
          user: path.user_guid
          details: requestBody.micro_deposit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/micro_deposits/{micro_deposit_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of a microdeposit
      effect: read
      questions:
      - Has a user's microdeposit been verified yet?
      - Can I force a microdeposit status refresh instead of waiting for the webhook?
      instructions:
      - text: Get microdeposit {micro_deposit} for user {user}.
        slots:
          micro_deposit: path.micro_deposit_guid
          user: path.user_guid
      - text: Check whether microdeposit {micro_deposit} for user {user} is VERIFIED.
        slots:
          micro_deposit: path.micro_deposit_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/micro_deposits/{micro_deposit_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a microdeposit
      effect: destructive
      questions:
      - How do I cancel and remove a microdeposit verification I no longer need?
      - Can I delete a microdeposit record for a user?
      instructions:
      - text: Delete microdeposit {micro_deposit} for user {user}.
        slots:
          micro_deposit: path.micro_deposit_guid
          user: path.user_guid
      - text: Remove user {user}'s microdeposit {micro_deposit}.
        slots:
          user: path.user_guid
          micro_deposit: path.micro_deposit_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/micro_deposits/{micro_deposit_guid}/verify'].put
  update:
    x-apievangelist-phrasing:
      intent: Submit the microdeposit amounts to verify
      effect: write
      questions:
      - How does a user confirm the two small amounts that landed in their account?
      - After submitting deposit amounts, how do I know verification actually succeeded?
      instructions:
      - text: Verify microdeposit {micro_deposit} with amounts {amounts}.
        slots:
          micro_deposit: path.micro_deposit_guid
          amounts: requestBody.micro_deposit
      - text: Submit the deposited amounts {amounts} the user saw for microdeposit {micro_deposit}.
        slots:
          amounts: requestBody.micro_deposit
          micro_deposit: path.micro_deposit_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/account_verifications'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's account verifications
      effect: read
      questions:
      - Which of a user's accounts have been verified, and what state is each verification in?
      - Can I see all account verifications for a user in one list?
      instructions:
      - text: List account verifications for user {user}.
        slots:
          user: path.user_guid
      - text: Show the verification status of every account for user {user}.
        slots:
          user: path.user_guid
      method: generated
      generated: '2026-09-26'