---
title: "Create a new task item"
method: POST
path: "/v1/task-management"
tags: ["Task Management"]
---

# Create a new task item

`POST /v1/task-management`

Create a new task item in Comp AI. Manage task items and attachments linked to operational entities such as risks and vendors.

## Request body

- CreateTaskItemDto
  - `title` string, required — Task title
  - `description` string — Task description
  - `status` 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled' — Task status
  - `priority` 'urgent' | 'high' | 'medium' | 'low' — Task priority
  - `entityId` string, required — ID of the entity this task belongs to
  - `entityType` 'vendor' | 'risk', required — Type of entity
  - `assigneeId` string — Assignee member ID

## Response `201`

Task item created successfully

- TaskItemResponseDto
  - `id` string, required — Task item ID
  - `title` string, required — Task title
  - `description` object, nullable, required — Task description
  - `status` 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled', required — Task status
  - `priority` 'urgent' | 'high' | 'medium' | 'low', required — Task priority
  - `entityId` string, required — ID of the entity this task belongs to
  - `entityType` 'vendor' | 'risk', required — Type of entity
  - `assignee` TaskItemAssigneeDto, required
    - `id` string, required — Member ID
    - `user` object, required — User information
  - `createdBy` TaskItemCreatorDto, required
    - `id` string, required — Member ID
    - `user` object, required — User information
  - `updatedBy` TaskItemUpdaterDto, required
    - `id` string, required — Member ID
    - `user` object, required — User information
  - `createdAt` string, date-time, required — Creation timestamp
  - `updatedAt` string, date-time, required — Last update timestamp

---

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