---
title: "Create todo item"
method: POST
path: "/v1/todos"
tags: ["Todo"]
---

# Create todo item

`POST /v1/todos`

Create a new todo item.

## Request body

- object
  - `title` string, required — Title of the todo item.
  - `description` string, nullable — Description of the todo item.
  - `priority` 'normal' | 'important' | 'urgent' | 'critical', required — Priority of the todo item.
  - `owned_by` string, required — ID of the user who owns the todo item.
  - `due_date` string, date-time, nullable — Completion due date of the todo item.

## Response `201`

Example response

- object
  - `id` string, required — ID of the newly created resource.

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden
- `500` — Internal Server Error

## Changes

- **2023-06-14** `1057260fde29` — 2 info
  - api tag `Todo` added
  - api tag `Todos` removed
- **2023-06-12** `85d93a33204d` — 1 breaking, 2 info
  - the `due_date` request property format changed from no format to `date-time`
  - the request property `description` became nullable
  - the request property `due_date` became nullable
- **2023-05-24** `11f0e17a96b4` — 1 info
  - endpoint added
- **2023-03-18** `f157ff402bc1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/opcotech/apis/elemo-api/changes/v1/todos/post.md)

---

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