Google

Google Tasks API

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

Productivity & workspace#openapi#analytics#media

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

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

Endpoints 14

tasklists

  • GETReturns the authenticated user's specified task list./tasks/v1/users/@me/lists/:tasklistReturns the authenticated user's specified task list.
  • PUTUpdates the authenticated user's specified task list./tasks/v1/users/@me/lists/:tasklistUpdates the authenticated user's specified task list.
  • DELETEDeletes the authenticated user's specified task list/tasks/v1/users/@me/lists/:tasklistDeletes the authenticated user's specified task list. If the list contains assigned tasks, both the assigned tasks and the original tasks in the assignment…
  • PATCHUpdates the authenticated user's specified task list/tasks/v1/users/@me/lists/:tasklistUpdates the authenticated user's specified task list. This method supports patch semantics.
  • GETReturns all the authenticated user's task lists/tasks/v1/users/@me/lists?maxResults=0&pageToken=stringReturns all the authenticated user's task lists. A user can have up to 2000 lists at a time.
  • POSTCreates a new task list and adds it to the authenticated user's task lists/tasks/v1/users/@me/listsCreates a new task list and adds it to the authenticated user's task lists. A user can have up to 2000 lists at a time.

tasks

  • POSTClears all completed tasks from the specified task list/tasks/v1/lists/:tasklist/clearClears 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…
  • GETReturns the specified task./tasks/v1/lists/:tasklist/tasks/:taskReturns the specified task.
  • PUTUpdates the specified task./tasks/v1/lists/:tasklist/tasks/:taskUpdates the specified task.
  • DELETEDeletes the specified task from the task list/tasks/v1/lists/:tasklist/tasks/:taskDeletes the specified task from the task list. If the task is assigned, both the assigned task and the original task (in Docs, Chat Spaces) are deleted. To…
  • PATCHUpdates the specified task/tasks/v1/lists/:tasklist/tasks/:taskUpdates the specified task. This method supports patch semantics.
  • GETReturns all tasks in the specified task list/tasks/v1/lists/:tasklist/tasks?completedMax=string&completedMin=string&dueMax=string&dueMin=string&maxResults=0&pageToken=string&showAssigned=true&showCompleted=true&showDeleted=true&showHidden=true&updatedMin=stringReturns all tasks in the specified task list. Doesn't return assigned tasks by default (from Docs, Chat Spaces). A user can have up to 20,000 non-hidden tasks…
  • POSTCreates a new task on the specified task list/tasks/v1/lists/:tasklist/tasks?parent=string&previous=stringCreates a new task on the specified task list. Tasks assigned from Docs or Chat Spaces cannot be inserted from Tasks Public API; they can only be created by…
  • POSTMoves the specified task to another position in the destination task list/tasks/v1/lists/:tasklist/tasks/:task/move?destinationTasklist=string&parent=string&previous=stringMoves 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…

API details

Base URL
https://tasks.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 2 scopes
An API key in the key query parameter
Operations
14 operations on 6 pathsGET 4POST 4PUT 2PATCH 2DELETE 2
Main resources
tasks 8tasklists 6
Response formats
application/json
Description format
Google API Discovery, API version v1

How to test the Google Tasks API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Google Tasks API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 2 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Returns the authenticated user's specified task list.” (GET /tasks/v1/users/@me/lists/:tasklist), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Google Tasks API?

The Google Tasks API lets you manage your tasks and task lists. It is listed under Productivity & workspace and has 14 endpoints.

Who publishes the Google Tasks API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Google Tasks API?

Requests go to https://tasks.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Google Tasks API?

It accepts 2 methods: OAuth 2.0 (authorization code flow) with 2 scopes; an API key in the key query parameter.

How many endpoints does the Google Tasks API have?

14 operations on 6 paths (4 GET, 4 POST, 2 PUT, 2 PATCH, 2 DELETE). The largest groups are tasks, tasklists.

Is forking the Google Tasks API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.