---
title: "POST /tasks"
method: POST
path: "/tasks"
tags: ["Tasks"]
---

# POST /tasks

`POST /tasks`

Create a new task

## Request body

- CreateTaskPayload
  - `description` string, required — The task description
  - `dueDate` string, date, nullable — The due date in yyyy-mm-dd format
  - `jobId` number, nullable — Link this task to a job. Cannot be changed after creation.
  - `assignedEmployeeIds` number[] — Employee IDs to assign to this task

## Response `201`

Resource created successfully

- CreateTaskResponse
  - `result` string, required
  - `data` Task, required
    - `id` number, required
    - `description` string, required
    - `dueDate` string, date, nullable, required
    - `jobId` number, nullable, required
    - `status` union, required
      - 'pending'
      - 'completed'
    - `createdById` number, required
    - `createdAt` string, date-time, required
    - `completedAt` string, date-time, nullable, required
    - `completedById` number, nullable, required
    - `assignedEmployeeIds` number[], required
    - `links` Links[], required
      - `href` string, required
      - `rel` string, required
      - `type` 'GET' | 'POST' | 'PUT' | 'PATCH', required

## Other responses

- `4XX` — Client Request Errors
- `5XX` — Server Errors

---

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