Google Tasks

The Google Tasks API lets you search, read, and update Google Tasks content and metadata. You can create, update, delete, and organize tasks across multiple task lists, move tasks between positions, and manage task completion status programmatically.

1 APIs 0 Features

GoogleProductivityTask ManagementTasksTodoWorkspace

APIs

Google Tasks API v1

The Google Tasks API provides programmatic access to Google Tasks for managing task lists and individual tasks. Supports creating, reading, updating, deleting, moving, and clear...

Collections

Google Tasks API

OPEN

Pricing Plans

Google Tasks Plans Pricing

3 plans

PLANS

Rate Limits

Google Tasks Rate Limits

5 limits

RATE LIMITS

FinOps

Google Tasks Finops

FINOPS

Semantic Vocabularies

Tasks Context

9 classes · 4 properties

JSON-LD

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Google Tasks API
  version: v1
request:
  auth:
    type: oauth2
    flow: authorization_code
    authorizationUrl: https://accounts.google.com/o/oauth2/auth
    accessTokenUrl: https://oauth2.googleapis.com/token
    credentials:
      clientId: '{{clientId}}'
      clientSecret: '{{clientSecret}}'
items:
- info:
    name: List task lists
    type: http
  http:
    method: GET
    url: https://tasks.googleapis.com/tasks/v1/users/@me/lists
    params:
    - name: maxResults
      value: ''
      type: query
    - name: pageToken
      value: ''
      type: query
  docs: Returns all the authenticated user's task lists.
- info:
    name: Create a task list
    type: http
  http:
    method: POST
    url: https://tasks.googleapis.com/tasks/v1/users/@me/lists
    body:
      type: json
      data: '{}'
  docs: Creates a new task list.
- info:
    name: Get a task list
    type: http
  http:
    method: GET
    url: https://tasks.googleapis.com/tasks/v1/users/@me/lists/:taskListId
    params:
    - name: taskListId
      value: ''
      type: path
  docs: Returns the authenticated user's specified task list.
- info:
    name: Update a task list
    type: http
  http:
    method: PUT
    url: https://tasks.googleapis.com/tasks/v1/users/@me/lists/:taskListId
    params:
    - name: taskListId
      value: ''
      type: path
    body:
      type: json
      data: '{}'
  docs: Updates the authenticated user's specified task list.
- info:
    name: Patch a task list
    type: http
  http:
    method: PATCH
    url: https://tasks.googleapis.com/tasks/v1/users/@me/lists/:taskListId
    params:
    - name: taskListId
      value: ''
      type: path
    body:
      type: json
      data: '{}'
  docs: Updates the authenticated user's specified task list with patch semantics.
- info:
    name: Delete a task list
    type: http
  http:
    method: DELETE
    url: https://tasks.googleapis.com/tasks/v1/users/@me/lists/:taskListId
    params:
    - name: taskListId
      value: ''
      type: path
  docs: Deletes the authenticated user's specified task list.
- info:
    name: List tasks
    type: http
  http:
    method: GET
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/tasks
    params:
    - name: taskListId
      value: ''
      type: path
    - name: maxResults
      value: ''
      type: query
    - name: pageToken
      value: ''
      type: query
    - name: showCompleted
      value: ''
      type: query
    - name: showHidden
      value: ''
      type: query
    - name: dueMin
      value: ''
      type: query
    - name: dueMax
      value: ''
      type: query
  docs: Returns all tasks in the specified task list.
- info:
    name: Create a task
    type: http
  http:
    method: POST
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/tasks
    params:
    - name: taskListId
      value: ''
      type: path
    - name: parent
      value: ''
      type: query
    - name: previous
      value: ''
      type: query
    body:
      type: json
      data: '{}'
  docs: Creates a new task on the specified task list.
- info:
    name: Get a task
    type: http
  http:
    method: GET
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/tasks/:taskId
    params:
    - name: taskListId
      value: ''
      type: path
    - name: taskId
      value: ''
      type: path
  docs: Returns the specified task.
- info:
    name: Update a task
    type: http
  http:
    method: PUT
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/tasks/:taskId
    params:
    - name: taskListId
      value: ''
      type: path
    - name: taskId
      value: ''
      type: path
    body:
      type: json
      data: '{}'
  docs: Updates the specified task.
- info:
    name: Delete a task
    type: http
  http:
    method: DELETE
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/tasks/:taskId
    params:
    - name: taskListId
      value: ''
      type: path
    - name: taskId
      value: ''
      type: path
  docs: Deletes the specified task from the task list.
- info:
    name: Move a task
    type: http
  http:
    method: POST
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/tasks/:taskId/move
    params:
    - name: taskListId
      value: ''
      type: path
    - name: taskId
      value: ''
      type: path
    - name: parent
      value: ''
      type: query
    - name: previous
      value: ''
      type: query
  docs: Moves the specified task to another position in the task list.
- info:
    name: Clear completed tasks
    type: http
  http:
    method: POST
    url: https://tasks.googleapis.com/tasks/v1/lists/:taskListId/clear
    params:
    - name: taskListId
      value: ''
      type: path
  docs: Clears all completed tasks from the specified task list.
bundled: true