API Evangelist conversational phrasing for Clickup Task Checklists 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 Task Checklists API
  version: 1.0.0
extends: openapi/clickup-task-checklists-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/task/{task_id}/checklist'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a checklist to a task
      effect: write
      questions:
      - How do I add a to-do checklist to a ClickUp task?
      - Can I create a checklist on a task referenced by its custom task ID?
      instructions:
      - text: Add a checklist named {name} to task {task_id}.
        slots:
          name: requestBody.name
          task_id: path.task_id
      - text: Create checklist {name} on custom task {task_id} in Workspace {team_id}.
        slots:
          name: requestBody.name
          task_id: path.task_id
          team_id: query.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/checklist/{checklist_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or reorder a checklist
      effect: write
      questions:
      - Can I move a checklist above the others on a task?
      - Is renaming a checklist possible after it's created?
      instructions:
      - text: Rename checklist {checklist_id} to {name}.
        slots:
          checklist_id: path.checklist_id
          name: requestBody.name
      - text: Move checklist {checklist_id} to position {position} on its task.
        slots:
          checklist_id: path.checklist_id
          position: requestBody.position
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/checklist/{checklist_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a checklist from a task
      effect: destructive
      questions:
      - What's the way to remove an entire checklist from a task?
      - Does deleting a checklist also remove all its items?
      instructions:
      - text: Delete checklist {checklist_id}.
        slots:
          checklist_id: path.checklist_id
      - text: Remove the whole checklist {checklist_id} from its task.
        slots:
          checklist_id: path.checklist_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/checklist/{checklist_id}/checklist_item'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an item to a checklist
      effect: write
      questions:
      - Can I add a line item to a task checklist and assign it to someone?
      - What fields does a new checklist item take?
      instructions:
      - text: Add item {name} to checklist {checklist_id}.
        slots:
          name: requestBody.name
          checklist_id: path.checklist_id
      - text: Put {name} on checklist {checklist_id} and assign it to {assignee}.
        slots:
          name: requestBody.name
          checklist_id: path.checklist_id
          assignee: requestBody.assignee
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/checklist/{checklist_id}/checklist_item/{checklist_item_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update or resolve a checklist item
      effect: write
      questions:
      - How do I tick off a checklist item as done?
      - Can one checklist item be nested under another?
      instructions:
      - text: 'Mark item {checklist_item_id} on checklist {checklist_id} resolved: {resolved}.'
        slots:
          checklist_item_id: path.checklist_item_id
          checklist_id: path.checklist_id
          resolved: requestBody.resolved
      - text: Nest item {checklist_item_id} of checklist {checklist_id} under item {parent}.
        slots:
          checklist_item_id: path.checklist_item_id
          checklist_id: path.checklist_id
          parent: requestBody.parent
      - text: Rename checklist item {checklist_item_id} in {checklist_id} to {name}.
        slots:
          checklist_item_id: path.checklist_item_id
          checklist_id: path.checklist_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/checklist/{checklist_id}/checklist_item/{checklist_item_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a checklist item
      effect: destructive
      questions:
      - Can I remove a single line from a checklist without deleting the checklist?
      - Is a deleted checklist item gone for good?
      instructions:
      - text: Delete item {checklist_item_id} from checklist {checklist_id}.
        slots:
          checklist_item_id: path.checklist_item_id
          checklist_id: path.checklist_id
      - text: Remove line {checklist_item_id} of checklist {checklist_id}.
        slots:
          checklist_item_id: path.checklist_item_id
          checklist_id: path.checklist_id
      method: generated
      generated: '2026-09-26'