Skip to main content
GET
List lists
Requires the lists:read scope. You must be a member of the workspace. Access-restricted members only receive lists within their permitted folders or explicitly granted lists.

Path parameters

string
required
The numeric workspace ID.

Response

Returns an array of list objects.
number
required
List identifier.
number
required
ID of the workspace this list belongs to.
number | null
ID of the parent folder. null if the list is not inside a folder.
string
required
List name.
string | null
Icon identifier slug (e.g., "folder-1", "chart", "code"). null if not set.
string | null
List color.
number
required
Numeric sort position. Lists are ordered by this value ascending.
string
required
UTC ISO-8601 creation timestamp.