Skip to main content
Version: 2023-02-21

Move Task

PUT 

/projects/tasks/:taskId/home-list

Moves the task’s home list to another list. Response: { "success": true }. 409 has two causes and one status: the task is already on the destination list (including as an additional list), or it is not on the current home list. If it is already an additional member of the destination, DELETE /projects/lists/{listId}/tasks/{taskId} on that list, then call Move Task. There is no separate error code for the two causes.

Request​

Version stringrequired

API Version

Available optionsv3
taskId stringrequired

Task id

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Bodyrequired

    listIdstringrequired

    Destination home list ID

application/json

Successful response

Schema
    successbooleanrequired

    Always true when the HTTP status is 200. Allowed: true.

    Available optionstrue