TOtodoist
Folders

Get Folders

Changed on

Get all folders for a workspace.

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

get/api/v1/folders

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/folders
  • Auth
    none declared

Query parameters

workspace_idinteger required

ID of the workspace to list folders for.

Example:123456
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": [
    {
      "id": "1234",
      "name": "Design",
      "workspace_id": "123456",
      "default_order": 1,
      "default_order_key": "a1V",
      "child_order": 1
    }
  ],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}

Changes