---
title: "Updates a task list template."
method: PUT
path: "/taskbundles/{taskBundleId}/tasklisttemplates/{taskListTemplateId}"
tags: ["taskBundles"]
---

# Updates a task list template.

`PUT /taskbundles/{taskBundleId}/tasklisttemplates/{taskListTemplateId}`

<Check title="Required Permissions" icon="key">The user must be an admin or have `task-manage-config:write` permissions.</Check>

## Path parameters

- `taskBundleId` string, uuid, required
- `taskListTemplateId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- TaskListBundlePutForm
  - `name` string, required — The name of the list.
  - `isHiddenForConnectUsers` boolean, nullable — True if the task in this list will be not visible for external workspace users. False otherwise. If null, no change will be made.
  - `order` number, double, nullable — The order of the list.

## Response `200`

OK

- NestedTaskList
  - `id` string, uuid — The id of the task list.
  - `createdOn` string, date-time — The date this task list was created.
  - `createdBy` string, uuid — The id of the user who created this task list.
  - `updatedOn` string, date-time — The date this task list was last modified.
  - `updatedBy` string, uuid — The id of the user who last modified this task list.
  - `name` string, nullable — The name of the list.
  - `order` number, double, nullable — The order of the list.
  - `plannedDuration` integer, nullable — The planned duration for this task list, in seconds.
  - `totalPlannedDuration` integer, nullable — The total planned duration for this task list, including all primary tasks (parent tasks which have this tacklist as PrimaryTaskListId), in seconds. Calculated: sum PlannedDuration of primary tasks in list Archived task lists are not included in the calculation.
  - `totalPlannedDurationWithHierarchy` integer, nullable — The total planned duration for this task list, including all primary tasks (parent tasks which have this task list as PrimaryTaskListId), in seconds. Calculated: max(PlannedDuration, sum TotalPlannedDurationWithHierarchy of primary tasks in list) Archived task lists are not included in the calculation.
  - `isArchived` boolean — Whether the task list has been archived.
  - `isHiddenForConnectUsers` boolean — True if the task in this list will be not visible for external workspace users. False otherwise.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)