# 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 Widgets API
  version: 1.0.0
extends: openapi/mx-technologies-widgets-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: 4
- target: $.paths['/users/{user_guid}/connect_widget_url'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Connect widget URL (deprecated)
      effect: write
      questions:
      - Is there an older endpoint that returns just an embeddable MX Connect URL?
      - What config does the deprecated connect_widget_url call accept?
      instructions:
      - text: Request a Connect widget URL for user {user} from the deprecated endpoint.
        slots:
          user: path.user_guid
      - text: Get a legacy embeddable Connect link for {user} with config {config}.
        slots:
          user: path.user_guid
          config: requestBody.config
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/members/{member_guid}/oauth_window_uri'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OAuth window URI for a member by GUID
      effect: read
      questions:
      - How do I get the OAuth login link for a member I know by its MX GUID?
      - Can I skip aggregation after the OAuth flow on the GUID-based endpoint?
      instructions:
      - text: Generate an OAuth window URI for member GUID {member} of user GUID {user}.
        slots:
          member: path.member_guid
          user: path.user_guid
      - text: Get the OAuth link for MX member {member} under user {user} and redirect to {redirect_url}.
        slots:
          member: path.member_guid
          user: path.user_guid
          redirect_url: query.client_redirect_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/widget_urls'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an embeddable widget URL
      effect: write
      questions:
      - How do I embed the Connect, spending or insights widget in my app?
      - How long does a widget URL stay valid, and can I reuse it?
      - Can I request the widget in a specific language?
      instructions:
      - text: Request a widget URL for user {user} with {widget}.
        slots:
          user: path.user_guid
          widget: requestBody.widget_url
      - text: Get a {language} widget link for {user}.
        slots:
          language: header.Accept-Language
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_identifier}/members/{member_identifier}/oauth_window_uri'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OAuth window URI (versioned)
      effect: read
      questions:
      - On the versioned API, how do I get an OAuth link for a member referenced by my own ID?
      - Can the versioned OAuth window call enable app-to-app redirects?
      instructions:
      - text: Generate an OAuth window URI 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: Get the OAuth link for my member ID {member} under user ID {user} with app2app set to {app2app}.
        slots:
          member: path.member_identifier
          user: path.user_identifier
          app2app: query.enable_app2app
      method: generated
      generated: '2026-09-26'