update_task_list

update_task_list

Update attributes of a task list. Only provided fields are changed. The authenticated user must be a member of the list.

Use archive_task_list / unarchive_task_list to change archive state — those are not exposed here.

Input

Field	Type	Required	Description
listId	number	yes	Numeric ID of the list to update.
name	string	no	New display name. Must contain at least one non-whitespace character.
color	string	no	New color tag. See valid values below.

Valid color values: Gray, Red, Orange, Yellow, Amber, Lime, Green, Teal, Sky, Blue, Purple, Pink.

Example call

{
  "listId": 27,
  "name": "Q3 launch — frozen scope",
  "color": "Amber"
}

Output

A single text content block containing a JSON object with the updated list.

Field	Type	Description
id	number	Numeric ID of the list.
name	string	Display name after the update.
color	string	Color tag after the update.
isArchived	boolean	Archived state (unchanged by this tool).

Example output

{
  "id": 27,
  "name": "Q3 launch — frozen scope",
  "color": "Amber",
  "isArchived": false
}

Errors

The tool returns isError: true with an explanatory text block when the list ID doesn’t exist, name is empty, or the authenticated user is not a member of the list.