Sign in
Tasks

Get Tasks

Get all active tasks for the user.

All provided parameters are used to narrow down the list of tasks.

This is a paginated endpoint. See the Pagination guide for details on using cursor-based pagination.

get/api/v1/tasks

Query parameters

project_idstring nullable

String ID of the project to get tasks from

Example:6XGgm6PHrGgMpCFX
section_idstring nullable

String ID of the section to get tasks from

Example:6fFPHV272WWh3gpW
parent_idstring nullable

String ID of the parent task to get sub-tasks from

Example:6fFPHRxcmVqm4C84
labelstring nullable

Filter tasks by label name.

Example:next_action
idsstring nullable

A list of the task IDs to retrieve, this should be a comma separated list

Example:6XGgmFVcrG5RRjVr,6fFPHV272WWh3gpW
cursorstring nullable

An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request

Example:14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55
limitinteger

The number of objects to return in a page

Example:50

Response

Successful Response

next_cursorstring nullable required

Cursor for the next page of results, or null when there are no more results.

Example response

{
  "results": [],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}

Changes

Changed in 1 of the 10 revisions of this API.1

  • 69a962f1578f1See the full diff
    • ○

      added the required property results/items/order_key to the response with the 200 status

      response-required-property-added