Create Task

Create a new task associated with a project.

POST /tasks

cURL

curl -X POST http://localhost:3000/api/v1/tasks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Implement login",
    "projectId": "clxyz456",
    "status": "TODO",
    "priority": "HIGH"
  }'

201

{
  "id": "clxyz789",
  "title": "Implement login",
  "status": "TODO",
  "priority": "HIGH",
  "projectId": "clxyz456",
  "createdAt": "2026-03-18T01:00:00.000Z"
}

Body

title · string · required

Task title.

description · string

Task description.

projectId · string · required

ID of the project this task belongs to.

status · string

Task status (e.g., TODO, IN_PROGRESS, DONE).

priority · string

Task priority (e.g., LOW, MEDIUM, HIGH).

dueDate · string

ISO 8601 due date (e.g., 2026-04-01T00:00:00.000Z).

assigneeId · string

User ID of the assignee.

cURL

curl -X POST http://localhost:3000/api/v1/tasks \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Implement login",
    "projectId": "clxyz456",
    "status": "TODO",
    "priority": "HIGH"
  }'

201

{
  "id": "clxyz789",
  "title": "Implement login",
  "status": "TODO",
  "priority": "HIGH",
  "projectId": "clxyz456",
  "createdAt": "2026-03-18T01:00:00.000Z"
}