List task lists

GET /v1/lists

Returns every non-archived task list the authenticated user is a member of, scoped to the team the API key is bound to. Archived lists are never returned.

Request

This endpoint takes no query parameters or body. Only the standard auth headers are required.

Response

200 OK — array of task list objects:

Field	Type	Description
id	number	Numeric ID of the list.
name	string	Display name of the list.
color	string	Hex color (e.g. #3b82f6) used in the UI.

Example response

[
  { "id": 12, "name": "Marketing site", "color": "#3b82f6" },
  { "id": 19, "name": "Q1 launch",      "color": "#f59e0b" }
]