Delete List

Endpoint

URL: /:projectId/lists/:listId

Method: DELETE

Authentication Required: Yes

Deletes a sub-list owned by the authenticated user. Root lists cannot be deleted.

Header	Type	Required	Description
`Authorization`	`string`	Yes	Bearer token for authentication.

Parameter	Type	Required	Description
`listId`	`string`	Yes	The ID of the list to delete.

DELETE /proj1234/lists/list_abc
Authorization: Bearer <ACCESS_TOKEN>

(No response body)

{
  "error": "Missing list ID",
  "code": "list/invalid-id"
}

{
  "error": "List not found",
  "code": "list/not-found"
}

{
  "error": "Root lists cannot be deleted",
  "code": "list/cannot-delete-root"
}

{
  "error": "Server error",
  "code": "list/server-error",
  "details": "<Error message>"
}