Tasks: clear

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.