---
title: "POST /api/tasks"
method: POST
path: "/api/tasks"
tags: ["Practice Management"]
---

# POST /api/tasks

`POST /api/tasks`

Create a task

## Query parameters

- `status` integer
- `category` integer
- `due_at_date` string
- `due_at_unknown` string
- `since` string
- `due_at_since` string
- `assignee_user` integer
- `assignee_group` integer
- `due_at_range` string

## Response `201`

Created

- Task
  - `category` integer
  - `due_date` object — When the task is due
    - `time` string — Due date time
  - `archived` boolean
  - `associated_items` object[] — Associated task items
    - `task` integer
    - `type` 'Document' | 'Message' | 'Message Thread' | 'Lab result' | 'Lab order' | 'Patient' | 'Appointment' | 'Lab document' | 'Communication' — Can be one of `"Appointment"`, `"Patient"`, `"Message"`, `"Message Thread"`, `"Document"`, `"Lab order"`
    - `value` integer — ID of the specified type object
  - `assigned_by` string — ID of `/api/users/` who assigned the task
  - `assignee_user` string — Either `assignee_user` or `assignee_group` should be set
  - `created_at` string
  - `assignee_group` integer — Either `assignee_user` or `assignee_group` should be set
  - `updated_at` string
  - `created_by` string — ID of `/api/users` who created the task
  - `priority` '10' | '20' | '30' | '40' — Can be one of the following 10(Low), 20(Medium), 30(High), 40(Urgent)
  - `status` integer, required
  - `notes` object[] — Additional notes of the task
    - `archived` boolean
    - `task` integer — ID of `/api/tasks`
    - `text` string
    - `created_at` string
    - `updated_at` string
    - `created_by` string
    - `id` integer
  - `title` string, required
  - `id` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Permission Denied
- `404` — Not Found
- `405` — Method Not Allowed
- `500` — Internal Server Error

---

[API](https://skmtc.net/drchrono/apis/untitled-api.md) · [All operations](https://skmtc.net/drchrono/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drchrono/untitled-api/versions/e595797fe800/schema)