---
title: "Creates a checklist item for a task."
method: POST
path: "/tasks/{taskId}/checklistitems"
tags: ["checklistItems"]
---

# Creates a checklist item for a task.

`POST /tasks/{taskId}/checklistitems`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/tasks/{taskId}/checklistitems`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/awork-io/apis/awork-io/docs/tasks/:taskId/checklistitems/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a checklist item for a task. The new item is added to the task checklist. <Check title="Required Permissions" icon="key">The required permissions depend on the base type of the task. If the task is a project task, the user must have either `project-master-data:write` permissions or be assigned to the task. For a user's private task, no special permissions are required.</Check>

## Path parameters

- `taskId` string, uuid, required

## Request body

- ChecklistItemForm
  - `isDone` boolean: Whether the checklist item is done.
  - `name` string, required: The name of the checklist item.
  - `order` number, double, nullable: The order of the checklist item.

## Response `200`

OK

- ChecklistItem
  - `isDone` boolean: Whether the checklist item is done.
  - `name` string, required: The name of the checklist item.
  - `order` number, double, nullable: The order of the checklist item.
  - `id` string, uuid: The id of the checklist item.
  - `createdOn` string, date-time: The date this checklist item was created.
  - `createdBy` string, uuid: The id of the user who created this checklist item.
  - `updatedOn` string, date-time: The date this checklist item was last modified.
  - `updatedBy` string, uuid: The id of the user who last modified this checklist item.
  - `taskId` string, uuid: The id of the task this checklist item belongs to.

## Other responses

- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-12** `8e46cf415581`: 1 info
  - api operation id `PostTaskChecklistItemsByTaskId` removed and replaced with `checklistItems_PostTaskChecklistItemsByTaskId`
- **2026-08-21** `a13e7c704262`: 1 warning
  - the `name` request property's maxLength was set to `25000`

[Operation history](https://skmtc.dev/awork-io/apis/awork-io/changes/tasks/:taskId/checklistitems/post.md)

---

[API](https://skmtc.dev/awork-io/apis/awork-io.md) - [All operations](https://skmtc.dev/awork-io/apis/awork-io/llms.txt) - [OpenAPI document](https://skmtc.dev/awork-io/apis/awork-io/revisions/81151fac7e79?raw)