Method: tasks.move

Moves the specified task to another position in the destination task list. If the destination list is not specified, the task is moved within its current list. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks. A user can have up to 2,000 subtasks per task.

HTTP request

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
tasklist

string

Task list identifier.
task

string

Task identifier.

Query parameters

Parameters
parent

string

New parent task identifier. If the task is moved to the top level, this parameter is omitted. The task set as parent must exist in the task list and can not be hidden. Assigned tasks can not be set as parent task (have subtasks) or be moved under a parent task (become subtasks). Optional.
previous

string

New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted. The task set as previous must exist in the task list and can not be hidden. Optional.
destinationTasklist

string

Optional. Destination task list identifier. If set, the task is moved from tasklist to the destinationTasklist list. Otherwise the task is moved within its current list. Recurrent tasks cannot currently be moved between lists. Optional.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Task.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/tasks

For more information, see the Authorization guide.