Clears all completed tasks from the specified task list. The affected tasks will be marked as 'hidden' and no longer be returned by default when retrieving all tasks for a task list. Try it now or see an example.
Request
HTTP request
POST https://www.googleapis.com/tasks/v1/lists/tasklist/clear
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
tasklist |
string |
Task list identifier. |
Authorization
This request requires authorization with the following scope:
| Scope |
|---|
https://www.googleapis.com/auth/tasks |
For more information, see the authentication and authorization page.
Request body
Do not supply a request body with this method.
Response
If successful, this method returns an empty response body.
Examples
Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).
Java
Uses the Java client library.
service.tasks.clear("taskListID").execute();
PHP
Uses the PHP client library.
$service->clearTasks('taskListID', null);
Python
Uses the Python client library.
service.tasks().clear(tasklist='taskListID').execute()
.NET
Uses the .NET client library.
service.Tasks.Clear("taskListID").Fetch();
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.