API Evangelist conversational phrasing for Unified Tags Tag 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 Unified Tags Tag categories API
  version: 1.0.0
extends: openapi/adobe-suite-tag-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: 5
- target: $.paths['/unifiedtags/tagCategory'].get
  update:
    x-apievangelist-phrasing:
      intent: List unified tag categories
      effect: read
      questions:
      - What tag categories exist for organizing tags in Experience Platform?
      - Can I sort tag categories by name or page through them?
      instructions:
      - text: List all tag categories.
      - text: List tag categories sorted by {sortBy} in {sortOrder} order.
        slots:
          sortBy: query.sortBy
          sortOrder: query.sortOrder
      - text: Show {limit} tag categories starting at {start}.
        slots:
          limit: query.limit
          start: query.start
      method: generated
      generated: '2026-09-26'
- target: $.paths['/unifiedtags/tagCategory'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag category
      effect: write
      questions:
      - How do I create a new category to group unified tags?
      - Can I give a tag category a description when I make it?
      instructions:
      - text: Create a tag category named {name}.
        slots:
          name: requestBody.name
      - text: Create tag category {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/unifiedtags/tagCategory/{TAG_CATEGORY_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a tag category
      effect: read
      questions:
      - What are the details of one tag category?
      - Can I look up a tag category by its ID?
      instructions:
      - text: Get tag category {TAG_CATEGORY_ID}.
        slots:
          TAG_CATEGORY_ID: path.TAG_CATEGORY_ID
      - text: Show the details of tag category {TAG_CATEGORY_ID}.
        slots:
          TAG_CATEGORY_ID: path.TAG_CATEGORY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/unifiedtags/tagCategory/{TAG_CATEGORY_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag category
      effect: destructive
      questions:
      - Who is allowed to delete a tag category?
      - Can I remove a tag category we no longer need?
      instructions:
      - text: Delete tag category {TAG_CATEGORY_ID}.
        slots:
          TAG_CATEGORY_ID: path.TAG_CATEGORY_ID
      - text: Remove the tag category {TAG_CATEGORY_ID}.
        slots:
          TAG_CATEGORY_ID: path.TAG_CATEGORY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/unifiedtags/tagCategory/{TAG_CATEGORY_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a tag category
      effect: write
      questions:
      - How do I rename an existing tag category?
      - Does updating a tag category require admin rights?
      instructions:
      - text: Update tag category {TAG_CATEGORY_ID} with my changes.
        slots:
          TAG_CATEGORY_ID: path.TAG_CATEGORY_ID
      - text: Rename tag category {TAG_CATEGORY_ID} as I describe.
        slots:
          TAG_CATEGORY_ID: path.TAG_CATEGORY_ID
      method: generated
      generated: '2026-09-26'