clickup_move_task
Move a task from one List to another, handling status mappings and custom fields.
Instructions
Move a task to a new home List.
Calls the v3 endpoint
PUT /workspaces/{workspace_id}/tasks/{task_id}/home_list/{list_id}. Because
the destination List may use different statuses, pass status_mappings when
the task's current status does not exist there. move_custom_fields /
custom_fields_to_move control whether the source List's custom-field values
travel with the task. workspace_id falls back to CLICKUP_TEAM_ID.
When to Use:
To relocate a task from one List to another.
When NOT to Use:
To keep a task in multiple Lists simultaneously (that is the tasks-in- multiple-lists ClickApp, handled by the Lists tools' add/remove).
To edit a task's fields in place — use
clickup_update_task.
Returns: A confirmation string.
Examples:
params = {"task_id": "86cxy1", "list_id": "902", "status_mappings": [{"from": "to do", "to": "open"}]}
Error Handling: 400 typically means a status in the source List has no mapping in the target; 404 means the task or List id is wrong.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |