API Evangelist conversational phrasing for Mx Technologies Taggings 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 Taggings API
  version: 1.0.0
extends: openapi/mx-technologies-taggings-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}/taggings'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's tag-to-transaction links
      effect: read
      questions:
      - Which transactions has a user attached tags to?
      - Can I see every tagging a user has created?
      instructions:
      - text: List taggings for user {user}.
        slots:
          user: path.user_guid
      - text: Show all tag assignments for user {user}, {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}/taggings'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach a tag to a transaction
      effect: write
      questions:
      - How do I label a transaction with a tag like Business Trip?
      - Can I link an existing tag to a specific transaction?
      instructions:
      - text: Create tagging {tagging} for user {user}.
        slots:
          tagging: requestBody.tagging
          user: path.user_guid
      - text: Tag a transaction for user {user} using {tagging}.
        slots:
          user: path.user_guid
          tagging: requestBody.tagging
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/taggings/{tagging_guid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one tagging
      effect: read
      questions:
      - Which tag and transaction does a particular tagging connect?
      - How do I look up a tagging by its GUID?
      instructions:
      - text: Get tagging {tagging} for user {user}.
        slots:
          tagging: path.tagging_guid
          user: path.user_guid
      - text: Show which transaction and tag tagging {tagging} links for user {user}.
        slots:
          tagging: path.tagging_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/taggings/{tagging_guid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change which tag a tagging uses
      effect: write
      questions:
      - How do I move a transaction's tag assignment to a different tag?
      - Can I edit an existing tagging instead of deleting and recreating it?
      instructions:
      - text: Update tagging {tagging} for user {user} with {changes}.
        slots:
          tagging: path.tagging_guid
          user: path.user_guid
          changes: requestBody.tagging
      - text: Reassign user {user}'s tagging {tagging} to a different tag.
        slots:
          user: path.user_guid
          tagging: path.tagging_guid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{user_guid}/taggings/{tagging_guid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a tag from a transaction
      effect: destructive
      questions:
      - How do I untag a transaction?
      - Does removing a tagging delete the tag itself?
      instructions:
      - text: Delete tagging {tagging} for user {user}.
        slots:
          tagging: path.tagging_guid
          user: path.user_guid
      - text: Remove the tag assignment {tagging} from user {user}'s transaction.
        slots:
          tagging: path.tagging_guid
          user: path.user_guid
      method: generated
      generated: '2026-09-26'