v1

latestOpenAPI 3.1.02026-07-24172151607.6 KB
Tasks

Move a task to a new 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.

put/api/v3/workspaces/{workspace_id}/tasks/{task_id}/home_list/{list_id}

Path parameters

workspace_idinteger required

The ID of the Workspace.

task_idstring required

The ID of the requested Task.

list_idstring required

The ID of the List to move the task to.

Request body

move_custom_fieldsboolean

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

custom_fields_to_movestring[]

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

Response

Example response

{
  "data": {
    "task_id": "123",
    "new_list_id": "123"
  }
}