Skip to content

API: Lists

Lists group tasks inside a workspace. Every list has a color, picked automatically at creation.

GET /api/workspaces/{workspaceId}/lists
[
{ "id": "019f…", "name": "Groceries", "color": "#22d3ee" },
{ "id": "019f…", "name": "House", "color": "#f471b5" }
]
POST /api/workspaces/{workspaceId}/lists
{ "name": "Groceries" }

Returns 201 with { "id": "…" }.

PUT /api/workspaces/{workspaceId}/lists/{listId}
{ "name": "Weekly groceries" }

Returns 200.

DELETE /api/workspaces/{workspaceId}/lists/{listId}

Returns 204. Tasks in the list are not deleted — they keep existing without a list (listId becomes null).