# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for MX Platform managed data [deprecated] API
  version: 1.0.0
extends: openapi/mx-technologies-managed-data-deprecated-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: 16
- target: $.paths['/managed_institutions'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed-data institutions (deprecated)
      effect: read
      questions:
      - Which institutions does the deprecated managed-data API still list for partner-supplied members?
      - Does the old versioned institutions list for managed data support paging?
      instructions:
      - text: List managed-data institutions on the deprecated endpoint with API version {api_version}.
        slots:
          api_version: header.Accept-Version
      - text: Fetch page {page} of institutions from the legacy managed-data list.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's managed members (deprecated)
      effect: read
      questions:
      - Where do I list partner-managed members on the deprecated versioned API?
      - Can the legacy managed-data endpoint still return all self-supplied members for one user?
      instructions:
      - text: List managed members for user {user} via the deprecated API, version {api_version}.
        slots:
          user: path.user_guid
          api_version: header.Accept-Version
      - text: Pull every legacy partner-managed member belonging to user {user}.
        slots:
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a managed member (deprecated)
      effect: write
      questions:
      - Can I still create a partner-managed member through the deprecated versioned endpoint?
      - What body does the legacy create-managed-member call expect?
      instructions:
      - text: Create a managed member for user {user} on the deprecated API with {member}.
        slots:
          user: path.user_guid
          member: requestBody.member
      - text: Use the legacy endpoint and API version {api_version} to add a self-supplied member for user {user}.
        slots:
          api_version: header.Accept-Version
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a managed member (deprecated)
      effect: read
      questions:
      - How do I read a partner-managed member using the deprecated managed-data API?
      - Is the old versioned read for a single managed member still available?
      instructions:
      - text: Read managed member {member} of user {user} through the deprecated API.
        slots:
          member: path.member_guid
          user: path.user_guid
      - text: Fetch legacy managed member {member} for user {user} with API version {api_version}.
        slots:
          member: path.member_guid
          user: path.user_guid
          api_version: header.Accept-Version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a managed member (deprecated)
      effect: write
      questions:
      - Can I edit a partner-managed member through the deprecated versioned endpoint?
      - Which call on the legacy managed-data API changes a member's attributes?
      instructions:
      - text: On the deprecated API, update managed member {member} of user {user} with {member_fields}.
        slots:
          member: path.member_guid
          user: path.user_guid
          member_fields: requestBody.member
      - text: Rename legacy managed 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}/managed_members/{member_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed member (deprecated)
      effect: destructive
      questions:
      - How do I delete a partner-managed member on the deprecated managed-data API?
      - Does the legacy managed-member delete return 204 No Content?
      instructions:
      - text: Delete managed member {member} of user {user} via the deprecated API.
        slots:
          member: path.member_guid
          user: path.user_guid
      - text: Remove legacy managed member {member} for user {user} using API version {api_version}.
        slots:
          member: path.member_guid
          user: path.user_guid
          api_version: header.Accept-Version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a managed member's accounts (deprecated)
      effect: read
      questions:
      - Where are a partner-managed member's accounts listed on the deprecated versioned API?
      - Can the old managed-data endpoint page through a managed member's accounts?
      instructions:
      - text: List managed accounts of member {member}, user {user} via the deprecated API.
        slots:
          member: path.member_guid
          user: path.user_guid
      - text: Pull legacy managed accounts under member {member} for user {user}, version {api_version}.
        slots:
          member: path.member_guid
          user: path.user_guid
          api_version: header.Accept-Version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a managed account (deprecated)
      effect: write
      questions:
      - Can I still add an account to a partner-managed member through the deprecated endpoint?
      - What account payload does the legacy create-managed-account call take?
      instructions:
      - text: On the deprecated API, create an account under managed member {member} of user {user} with {account}.
        slots:
          member: path.member_guid
          user: path.user_guid
          account: requestBody.account
      - text: Add a legacy managed account to member {member} for user {user}.
        slots:
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a managed account (deprecated)
      effect: read
      questions:
      - How do I read one partner-managed account through the deprecated managed-data API?
      - Is the old versioned single-account read for managed data still usable?
      instructions:
      - text: Read managed account {account} of member {member}, user {user} via the deprecated API.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Fetch legacy managed account {account} in member {member} for user {user}, version {api_version}.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
          api_version: header.Accept-Version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a managed account (deprecated)
      effect: write
      questions:
      - Can I change a partner-managed account's balance on the deprecated versioned API?
      - Which legacy managed-data call edits an account's attributes?
      instructions:
      - text: On the deprecated API, apply {account_fields} to managed account {account} in member {member}, user {user}.
        slots:
          account_fields: requestBody.account
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Change the balance on legacy managed account {account} under member {member} for user {user}.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed account (deprecated)
      effect: destructive
      questions:
      - I need to drop one self-supplied account from a managed member on the old deprecated API; which call?
      - What status comes back when the legacy endpoint deletes a managed account?
      instructions:
      - text: 'Deprecated API: erase account {account} held by managed member {member} of user {user}.'
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Remove legacy managed account {account} from member {member} for user {user}.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed transactions (deprecated)
      effect: read
      questions:
      - Where do I list partner-managed transactions on the deprecated versioned API?
      - Can the legacy managed-transactions list filter by from and to dates?
      instructions:
      - text: List managed transactions on account {account}, member {member}, user {user} via the deprecated API.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Pull legacy managed transactions for account {account} in member {member}, user {user} since {from_date}.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
          from_date: query.from_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a managed transaction (deprecated)
      effect: write
      questions:
      - Can I still load a transaction into a partner-managed account through the deprecated endpoint?
      - What transaction body does the legacy managed-data create call accept?
      instructions:
      - text: On the deprecated API, create a transaction on managed account {account}, member {member}, user {user} with {transaction}.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
          transaction: requestBody.transaction
      - text: Add a legacy managed transaction to account {account} under member {member} for user {user}.
        slots:
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a managed transaction (deprecated)
      effect: read
      questions:
      - Which deprecated call returns a single self-supplied transaction by its GUID?
      - Is the legacy single-transaction read for managed data still around?
      instructions:
      - text: Read managed transaction {transaction} on account {account}, member {member}, user {user} via the deprecated API.
        slots:
          transaction: path.transaction_guid
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Fetch legacy managed transaction {transaction} in account {account} of member {member}, user {user}.
        slots:
          transaction: path.transaction_guid
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a managed transaction (deprecated)
      effect: write
      questions:
      - Can I correct a partner-managed transaction on the deprecated versioned API?
      - Which legacy managed-data call edits a transaction's amount or description?
      instructions:
      - text: Using the deprecated API, change transaction {transaction} (account {account}, member {member}, user {user}) to {transaction_fields}.
        slots:
          transaction_fields: requestBody.transaction
          transaction: path.transaction_guid
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Fix legacy managed transaction {transaction} on account {account} of member {member}, user {user}.
        slots:
          transaction: path.transaction_guid
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/managed_members/{member_guid}/accounts/{account_guid}/transactions/{transaction_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed transaction (deprecated)
      effect: destructive
      questions:
      - Can I remove a single self-supplied purchase or deposit with the old deprecated endpoint?
      - Does the legacy delete for a managed transaction return an empty 204?
      instructions:
      - text: Delete managed transaction {transaction} on account {account}, member {member}, user {user} via the deprecated API.
        slots:
          transaction: path.transaction_guid
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      - text: Remove legacy managed transaction {transaction} from account {account} of member {member}, user {user}.
        slots:
          transaction: path.transaction_guid
          account: path.account_guid
          member: path.member_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'