---
title: "Create a task"
method: POST
path: "/v1/tasks"
tags: ["Personal Tasks"]
---

# Create a task

`POST /v1/tasks`

Create a new task

## Headers

- `X-Org-Id` integer, required

## Request body

- TaskCreateRequest — DTO for creating a new task. This object is used to transfer data from the client to the server when creating a new task.
  - `taskTitle` string — Title of the task. Must be between 3 and 500 characters.
  - `description` string — Description of the task.
  - `owners` integer[] — List of owner IDs assigned to the task.
  - `startDate` string, date-time — Start date of the task.
  - `dueDate` string, date-time — Due date of the task.
  - `noOfDays` integer — Duration in working days. When sent together with startDate or dueDate, the missing date is computed by honouring the organisation's operational hours.
  - `completion` integer — Completion percentage of the task. Must be between 0 and 100.
  - `status` string — Status of the task.
  - `priority` string — Priority of the task.
  - `tags` string[] — List of tags associated with the task.

## Response `200`

Task created successfully

---

[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/versions/237f5bbd4029/schema)