TOtodoist
Folders

Get Folder

Changed on

Return the folder for the given folder ID.

get/api/v1/folders/{folder_id}

Request

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

Path parameters

folder_idinteger required

ID of the folder to return.

Example:1234

Response

Successful Response

idstring required

String ID of the folder.

namestring required

Folder name.

workspace_idstring required

String ID of the workspace that contains the folder.

default_orderinteger required

Default position of the folder in the workspace.

default_order_keystring nullable required

Fractional-indexing key for the workspace's shared default-ordering scope (folders and workspace projects together). null until assigned (backfill pending).

child_orderinteger required

User-specific position of the folder.

is_deletedboolean required

Whether the folder is deleted.

Example response

{
  "id": "1234",
  "name": "Design",
  "workspace_id": "123456",
  "default_order": 1,
  "default_order_key": "a1V",
  "child_order": 1
}

Changes