API Docs

Move a task to a new List

put
https://api.clickup.com/api/v3/workspaces//tasks//home_list/

Move a task to a new List. For Tasks in Multiple Lists, this endpoint only moves the task to a new home List.

Learn more about the options available when moving a task to a new List.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the Workspace.

string
required

The ID of the requested Task.

string
required

The ID of the List to move the task to.

Body Params
boolean

Add Custom Fields from the current List to the new List.

custom_fields_to_move
array of strings

An array of Custom Fields IDs to move. This parameter is not required to move all Custom Fields to the new List.

custom_fields_to_move
status_mappings
array of objects

Map the current List statuses to the statuses in the new List. You only need to include the ID of the task's current status and the ID of it's new status.

Note: This parameter is required if the task's current status is not available in the new List.

status_mappings
Responses

Updated 4 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago