API Evangelist conversational phrasing for Mx Technologies Goals 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 Goals API
  version: 1.0.0
extends: openapi/mx-technologies-goals-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}/goals'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's savings and debt goals
      effect: read
      questions:
      - What financial goals has a user set up?
      - Can I page through all of a user's goals?
      instructions:
      - text: List all goals for user {user}.
        slots:
          user: path.user_guid
      - text: Show page {page} of {user}'s goals.
        slots:
          page: query.page
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/goals'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a financial goal
      effect: write
      questions:
      - How do I set up a savings goal for a user?
      - Can I create a goal without firing a webhook?
      instructions:
      - text: Create a goal for user {user} with {goal}.
        slots:
          user: path.user_guid
          goal: requestBody.goal
      - text: Add a new savings goal for {user}.
        slots:
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/goals/{goal_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one goal
      effect: read
      questions:
      - What's the target amount and progress on a specific goal?
      - Can I fetch a single goal by its GUID?
      instructions:
      - text: Get goal {goal} for user {user}.
        slots:
          goal: path.goal_guid
          user: path.user_guid
      - text: Show the details and progress of {user}'s goal {goal}.
        slots:
          goal: path.goal_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/goals/{goal_guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a goal
      effect: write
      questions:
      - Can I change the target amount or name of an existing goal?
      - Which call edits one goal's details?
      instructions:
      - text: Update goal {goal} for user {user} with {goal_fields}.
        slots:
          goal: path.goal_guid
          user: path.user_guid
          goal_fields: requestBody.goal
      - text: Change the target on {user}'s goal {goal}.
        slots:
          goal: path.goal_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/goals/{goal_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a goal
      effect: destructive
      questions:
      - How do I remove a goal a user no longer wants?
      - Is deleting a goal permanent?
      instructions:
      - text: Delete goal {goal} for user {user}.
        slots:
          goal: path.goal_guid
          user: path.user_guid
      - text: Remove {user}'s goal {goal}.
        slots:
          goal: path.goal_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/goals/reposition'].put
  update:
    x-apievangelist-phrasing:
      intent: Reorder a user's goal priorities
      effect: write
      questions:
      - How do I change which goal is the user's top priority?
      - If I lower one goal's priority, do the others shift automatically?
      instructions:
      - text: 'Reposition the goals for user {user} to this order: {goals}.'
        slots:
          user: path.user_guid
          goals: requestBody.goals
      - text: Reprioritize the goal order for {user}.
        slots:
          user: path.user_guid
      method: generated
      generated: '2026-09-26'