unarchive_task_list

unarchive_task_list

Restore a previously-archived task list, making it visible again in list_task_lists and in the web sidebar. The authenticated user must be a member of the list.

Idempotent — unarchiving a non-archived list returns success.

Connected web clients receive a realtime tasklists refetch event so the list reappears in their sidebar.

Input

Field	Type	Required	Description
listId	number	yes	Numeric ID of the list to unarchive.

Example call

{
  "listId": 27
}

Output

A single text content block containing a JSON object describing the restored list.

Field	Type	Description
id	number	Numeric ID of the list.
name	string	Display name of the list.
color	string	Color tag of the list.
isArchived	boolean	Always false.

Example output

{
  "id": 27,
  "name": "Q3 launch",
  "color": "Blue",
  "isArchived": false
}

Errors

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