Tasks API

The Google Tasks API lets you manage your tasks and task lists.

Service: tasks.googleapis.com

We recommend that you call this service using Google-provided client libraries. If your application needs to call this service using your own libraries, you should use the following information when making the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service may have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://tasks.googleapis.com

REST Resource: tasklists

Methods
delete DELETE /tasks/v1/users/@me/lists/{tasklist}
Deletes the authenticated user's specified task list.
get GET /tasks/v1/users/@me/lists/{tasklist}
Returns the authenticated user's specified task list.
insert POST /tasks/v1/users/@me/lists
Creates a new task list and adds it to the authenticated user's task lists.
list GET /tasks/v1/users/@me/lists
Returns all the authenticated user's task lists.
patch PATCH /tasks/v1/users/@me/lists/{tasklist}
Updates the authenticated user's specified task list.
update PUT /tasks/v1/users/@me/lists/{tasklist}
Updates the authenticated user's specified task list.

REST Resource: tasks

Methods
clear POST /tasks/v1/lists/{tasklist}/clear
Clears all completed tasks from the specified task list.
delete DELETE /tasks/v1/lists/{tasklist}/tasks/{task}
Deletes the specified task from the task list.
get GET /tasks/v1/lists/{tasklist}/tasks/{task}
Returns the specified task.
insert POST /tasks/v1/lists/{tasklist}/tasks
Creates a new task on the specified task list.
list GET /tasks/v1/lists/{tasklist}/tasks
Returns all tasks in the specified task list.
move POST /tasks/v1/lists/{tasklist}/tasks/{task}/move
Moves the specified task to another position in the task list.
patch PATCH /tasks/v1/lists/{tasklist}/tasks/{task}
Updates the specified task.
update PUT /tasks/v1/lists/{tasklist}/tasks/{task}
Updates the specified task.