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

# Create a task

`POST /tasks`

As with all POST endpoints, a location header will be returned with a url to the newly created resource.

## Request body

- object
  - `data_item` object — A DataItem the object is about, or null for a general task
    - `id` number
    - `type` string
  - `assigned_to_id` number — The user to assign the task to
  - `description` string
  - `priority` number — A number 1-5, with 1 being the lowest priority
  - `date_due` string — If null the task will be assigned ASAP as in the CATS UI

## Response `201`

Created

---

[API](https://skmtc.net/catsone/apis/cats-api-v3.md) · [All operations](https://skmtc.net/catsone/apis/cats-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catsone/cats-api-v3/revisions/dedbbade450d/schema)