API Evangelist conversational phrasing for Mx Technologies Statements 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 Statements API
  version: 1.0.0
extends: openapi/mx-technologies-statements-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: 5
- target: $.paths['/users/{user_guid}/members/{member_guid}/fetch_statements'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch new statements for a member by GUID
      effect: write
      questions:
      - How do I pull the latest account statements from a user's bank using MX GUIDs?
      - Can I trigger a statement fetch for a member identified by its GUID?
      instructions:
      - text: Fetch statements for member GUID {member} of user GUID {user}.
        slots:
          member: path.member_guid
          user: path.user_guid
      - text: Start a statement pull on MX member {member} under user {user}.
        slots:
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/members/{member_guid}/statements'].get
  update:
    x-apievangelist-phrasing:
      intent: List a member's available statements
      effect: read
      questions:
      - Which statements have already been retrieved for a member?
      - Can I page through the statements available for one connection?
      instructions:
      - text: List statements for member {member} of user {user}.
        slots:
          member: path.member_guid
          user: path.user_guid
      - text: Show the available statements on {user}'s member {member}.
        slots:
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/members/{member_guid}/statements/{statement_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a statement's details as JSON
      effect: read
      questions:
      - Can I get the metadata of one statement as JSON rather than the PDF?
      - What information does a single statement record contain?
      instructions:
      - text: Read statement {statement} of member {member} for user {user}.
        slots:
          statement: path.statement_guid
          member: path.member_guid
          user: path.user_guid
      - text: Show the JSON for statement {statement} on {user}'s member {member}.
        slots:
          statement: path.statement_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/members/{member_guid}/statements/{statement_guid}.pdf'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a statement PDF
      effect: read
      questions:
      - How do I download the actual PDF of a bank statement?
      - Is there a way to get the statement file itself for a user?
      instructions:
      - text: Download the PDF of statement {statement} from member {member} for user {user}.
        slots:
          statement: path.statement_guid
          member: path.member_guid
          user: path.user_guid
      - text: Save {user}'s statement {statement} from member {member} as a PDF.
        slots:
          statement: path.statement_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_identifier}/members/{member_identifier}/fetch_statements'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch statements for a member (versioned)
      effect: write
      questions:
      - On the versioned API, can I fetch statements for a member I reference by my own ID?
      - Which call pulls statements using an Accept-Version header and member identifier?
      instructions:
      - text: Fetch statements for member {member} of user {user} on API version {api_version}.
        slots:
          member: path.member_identifier
          user: path.user_identifier
          api_version: header.Accept-Version
      - text: Pull statements for my member ID {member} under user ID {user}.
        slots:
          member: path.member_identifier
          user: path.user_identifier
      method: generated
      generated: '2026-09-26'