---
title: "Add a new task on a project"
method: POST
path: "/v1/workspaces/{workspaceId}/projects/{projectId}/tasks"
tags: ["Task"]
---

# Add a new task on a project

`POST /v1/workspaces/{workspaceId}/projects/{projectId}/tasks`

## Path parameters

- `projectId` string, required — Represents a project identifier across the system.
- `workspaceId` string, required — Represents a workspace identifier across the system.

## Query parameters

- `contains-assignee` boolean — Flag to set whether task will have assignee or none.

## Request body

- TaskRequestV1
  - `assigneeId` string
  - `assigneeIds` string[] — Represents list of assignee ids for the task.
  - `budgetEstimate` integer — Represents a task budget estimate as long.
  - `estimate` string — Represents a task duration estimate in ISO-8601 format.
  - `id` string — Represents task identifier across the system.
  - `name` string, required — Represents task name.
  - `status` 'ACTIVE' | 'DONE' | 'ALL' — Represents task status.
  - `userGroupIds` string[] — Represents list of user group ids for the task.

## Response `201`

Created

- TaskDtoV1 — unresolved $ref

## Changes

- **2026-08-20** `a5b636acbcd8` — 16 info
  - the `` request property default value `` was added
  - the `` request property default value `` was added
  - the `assigneeId` request property default value `` was added
  - the `estimate` request property default value `` was added
  - …12 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/projects/:projectId/tasks/post.md)

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)