API Evangelist conversational phrasing for Mx Technologies Categories 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 Categories API
  version: 1.0.0
extends: openapi/mx-technologies-categories-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: 8
- target: $.paths['/categories/default'].get
  update:
    x-apievangelist-phrasing:
      intent: List the standard spending categories
      effect: read
      questions:
      - What built-in transaction categories and subcategories does MX offer?
      - Can I get the full default category tree without referencing any user?
      instructions:
      - text: List all default categories and subcategories.
      - text: Show page {page} of the platform-wide default categories.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/categories/{category_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one default category
      effect: read
      questions:
      - How do I look up the name and parent of a built-in category by its GUID?
      - Which top-level category does a given default subcategory belong to?
      instructions:
      - text: Get default category {category}.
        slots:
          category: path.category_guid
      - text: Show details of the built-in category {category}, no user needed.
        slots:
          category: path.category_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's default and custom categories
      effect: read
      questions:
      - Which categories can a user assign, including the custom ones they made?
      - How do I see a user's own custom categories alongside the standard ones?
      instructions:
      - text: List all categories, custom included, for user {user}.
        slots:
          user: path.user_guid
      - text: Show user {user}'s full category list with their custom categories, {per_page} per page.
        slots:
          user: path.user_guid
          per_page: query.records_per_page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/categories'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom category for a user
      effect: write
      questions:
      - Can a user add their own spending category, like Pet Supplies?
      - How do I create a custom subcategory under an existing parent category?
      instructions:
      - text: Create custom category {category} for user {user}.
        slots:
          category: requestBody.category
          user: path.user_guid
      - text: Add a new user-defined category {category} to user {user}'s list.
        slots:
          category: requestBody.category
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/categories/default'].get
  update:
    x-apievangelist-phrasing:
      intent: List default categories scoped to a user
      effect: read
      questions:
      - How do I fetch only the standard categories, excluding custom ones, for a particular user?
      - Can I list the default category set in the context of a specific user?
      instructions:
      - text: List only the default categories for user {user}.
        slots:
          user: path.user_guid
      - text: Show the built-in categories scoped to user {user}, page {page}, without custom ones.
        slots:
          user: path.user_guid
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/categories/{category_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a user's category, custom or default
      effect: read
      questions:
      - How do I read a custom category a user created?
      - Can I look up any category, default or custom, in the context of a user?
      instructions:
      - text: Get category {category} for user {user}.
        slots:
          category: path.category_guid
          user: path.user_guid
      - text: Show the custom category {category} that user {user} made.
        slots:
          category: path.category_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/categories/{category_guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or edit a custom category
      effect: write
      questions:
      - How do I rename a custom category a user created?
      - Can I change the attributes of a user's custom category after creating it?
      instructions:
      - text: Update custom category {category} for user {user} with {changes}.
        slots:
          category: path.category_guid
          user: path.user_guid
          changes: requestBody.category
      - text: Rename user {user}'s custom category {category}.
        slots:
          user: path.user_guid
          category: path.category_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/categories/{category_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom category
      effect: destructive
      questions:
      - How do I remove a custom category a user no longer needs?
      - Can default categories be deleted, or only custom ones?
      instructions:
      - text: Delete custom category {category} for user {user}.
        slots:
          category: path.category_guid
          user: path.user_guid
      - text: Remove user {user}'s custom category {category} permanently.
        slots:
          user: path.user_guid
          category: path.category_guid
      method: generated
      generated: '2026-09-26'