Method: tasks.move

Stay organized with collections Save and categorize content based on your preferences.

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.

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