Method: tasks.move

Moves the specified task to another position in the task 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. Optional.

previous

string

New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted. 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.