- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
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 |
Task list identifier. |
task |
Task identifier. |
Query parameters
| Parameters | |
|---|---|
parent |
New parent task identifier. If the task is moved to the top level, this parameter is omitted. Assigned tasks can not be set as parent task (have subtasks) or be moved under a parent task (become subtasks). Optional. |
previous |
New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted. Optional. |
destinationTasklist |
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.