For a list of methods for this resource, see the end of this page.

Resource representations

  "kind": "tasks#task",
  "id": string,
  "etag": etag,
  "title": string,
  "updated": datetime,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": datetime,
  "completed": datetime,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
      "type": string,
      "description": string,
      "link": string
Property name Value Description Notes
kind string Type of the resource. This is always "tasks#task".
id string Task identifier.
etag etag ETag of the resource.
title string Title of the task.
updated datetime Last modification time of the task (as a RFC 3339 timestamp).
parent string Parent task identifier. This field is omitted if it is a top-level task. This field is read-only. Use the "move" method to move the task under a different parent or to the top level.
position string String indicating the position of the task among its sibling tasks under the same parent task or at the top level. If this string is greater than another task's corresponding position string according to lexicographical ordering, the task is positioned after the other task under the same parent task (or at the top level). This field is read-only. Use the "move" method to move the task to another position.
notes string Notes describing the task. Optional.
status string Status of the task. This is either "needsAction" or "completed".
due datetime Due date of the task (as a RFC 3339 timestamp). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn't possible to read or write the time that a task is due via the API.
completed datetime Completion date of the task (as a RFC 3339 timestamp). This field is omitted if the task has not been completed.
deleted boolean Flag indicating whether the task has been deleted. The default if False.
hidden boolean Flag indicating whether the task is hidden. This is the case if the task had been marked completed when the task list was last cleared. The default is False. This field is read-only.
links[].type string Type of the link, e.g. "email".
links[].description string The description. In HTML speak: Everything between <a> and </a>.


Returns all tasks in the specified task list.
Returns the specified task.
Creates a new task on the specified task list. Fails with HTTP code 403 or 429 after reaching the storage limit of 100,000 tasks per account.
Updates the specified task.
Deletes the specified task from the task list.
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.
Moves the specified task to another position in the task list. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks.
Updates the specified task. This method supports patch semantics.