---
title: "Update a checklist of a subtask"
method: PUT
path: "/v1/tasks/{taskId}/subtasks/{subtaskId}/checklists/{checklistId}"
tags: ["Tasks Checklist"]
---

# Update a checklist of a subtask

`PUT /v1/tasks/{taskId}/subtasks/{subtaskId}/checklists/{checklistId}`

Replace name, completion state and assignee of the given subtask checklist item. Every field is applied as sent, so omitting assigneeId unassigns the item.

## Path parameters

- `taskId` integer, required
- `subtaskId` integer, required
- `checklistId` integer, required

## Headers

- `X-Org-Id` integer, required

## Request body

- ChecklistUpdateRequest — Request object for updating a checklist item. The request carries the complete desired state of the item: every field is applied as sent, so `assigneeId` must be repeated to keep the current assignee and omitted to unassign the item.
  - `checkListName` string, required — Name of the checklist item. Must be between 3 and 150 characters.
  - `completed` boolean, required — Completion state of the checklist item.
  - `assigneeId` integer — User ID the checklist item is assigned to. The user must be an active member of the organisation. Omit to unassign the item.

## Response `200`

Subtask checklist updated successfully

- ApiSuccessResponseTaskCheckListDto — Standard API success response structure
  - `success` boolean — Indicates if the operation was successful
  - `message` string — Message describing the result of the operation
  - `code` integer — HTTP status code of the response
  - `data` TaskCheckListDto
    - `tenantId` integer
    - `checkListId` integer
    - `checkListName` string
    - `completed` boolean
    - `parentId` integer
    - `taskId` integer
    - `subtaskId` integer
    - `createdBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `modifiedBy` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `assignee` UserMinimalDto
      - `userId` integer
      - `firstName` string
      - `email` string
      - `profilePicURL` string
      - `profilePicColor` string
      - `provider` string
      - `role` OrgRoleDto
        - `orgRoleId` integer
        - `roleName` string
    - `orderIndex` integer
    - `parent` boolean
  - `timestamp` string, date-time — Timestamp of the response

---

[API](https://skmtc.net/astravue/apis/astravue-api.md) · [All operations](https://skmtc.net/astravue/apis/astravue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astravue/astravue-api/revisions/c2b39b2c43c5/schema)