API Evangelist conversational phrasing for Clickup Tags API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Clickup Tags API
  version: 1.0.0
extends: openapi/clickup-tags-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['/v2/space/{space_id}/tag'].get
  update:
    x-apievangelist-phrasing:
      intent: List the task Tags in a Space
      effect: read
      questions:
      - What task Tags are available in a Space?
      - Can I see every tag defined for a ClickUp Space?
      instructions:
      - text: List the task Tags in Space {space_id}.
        slots:
          space_id: path.space_id
      - text: Show all tags available in Space {space_id}.
        slots:
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}/tag'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a task Tag in a Space
      effect: write
      questions:
      - How do I add a new tag to a Space so tasks can use it?
      - Can I set a tag's colors when I create it in a Space?
      instructions:
      - text: Create tag {tag} in Space {space_id}.
        slots:
          tag: requestBody.tag
          space_id: path.space_id
      - text: Add a new task Tag {tag} to Space {space_id}.
        slots:
          tag: requestBody.tag
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}/tag/{tag_name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or recolor a Space tag
      effect: write
      questions:
      - How do I rename an existing tag in a Space?
      - Can I change a Space tag's colors after creating it?
      instructions:
      - text: Update tag {tag_name} in Space {space_id} to {tag}.
        slots:
          tag_name: path.tag_name
          space_id: path.space_id
          tag: requestBody.tag
      - text: Rename Space {space_id} tag {tag_name} using the new definition {tag}.
        slots:
          space_id: path.space_id
          tag_name: path.tag_name
          tag: requestBody.tag
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/space/{space_id}/tag/{tag_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag from a Space
      effect: destructive
      questions:
      - How do I delete a tag entirely from a Space?
      - What does removing a Space tag require in the request?
      instructions:
      - text: Delete tag {tag_name} from Space {space_id}, passing tag {tag}.
        slots:
          tag_name: path.tag_name
          space_id: path.space_id
          tag: requestBody.tag
      - text: Remove the {tag_name} tag from Space {space_id} altogether.
        slots:
          tag_name: path.tag_name
          space_id: path.space_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/task/{task_id}/tag/{tag_name}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a tag to a task (v2)
      effect: write
      questions:
      - What's the v2 endpoint for tagging a task?
      - Can I tag a task by its custom task ID through v2?
      instructions:
      - text: Via v2, add tag {tag_name} to task {task_id}.
        slots:
          tag_name: path.tag_name
          task_id: path.task_id
      - text: Using v2, tag custom task ID {task_id} in Workspace {team_id} with {tag_name}.
        slots:
          task_id: path.task_id
          team_id: query.team_id
          tag_name: path.tag_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/task/{task_id}/tag/{tag_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a tag from a task (v2)
      effect: destructive
      questions:
      - Does removing a tag from a task through v2 delete the tag from the Space?
      - What's the v2 way to untag a task?
      instructions:
      - text: Via v2, remove tag {tag_name} from task {task_id} but keep it in the Space.
        slots:
          tag_name: path.tag_name
          task_id: path.task_id
      - text: Using v2, untag {tag_name} from custom task ID {task_id} in Workspace {team_id}.
        slots:
          tag_name: path.tag_name
          task_id: path.task_id
          team_id: query.team_id
      method: generated
      generated: '2026-09-26'