---
title: "Create Action Item"
method: POST
path: "/v1/dev/user/action-items"
tags: ["Action Items"]
---

# Create Action Item

`POST /v1/dev/user/action-items`

Create a new action item for the authenticated user.

- **description**: The action item description (1-500 characters)
- **completed**: Whether the action item is completed (default: False)
- **due_at**: Optional due date in ISO 8601 format with timezone

## Request body

- CreateActionItemRequest
  - `completed` boolean — Whether the action item is completed
  - `description` string, required — The action item description
  - `due_at` string, date-time, nullable — When the action item is due (ISO format with timezone)

## Response `200`

Successful Response

- DeveloperActionItem
  - `completed` boolean, required
  - `completed_at` string, date-time, nullable
  - `conversation_id` string, nullable
  - `created_at` string, date-time, nullable
  - `description` string, required
  - `due_at` string, date-time, nullable
  - `id` string, required
  - `updated_at` string, date-time, nullable

## Other responses

- `401` — Missing or invalid authentication credentials.
- `403` — Authenticated, but the token does not grant the required scope.
- `422` — Validation Error

## Changes

> 28 revisions in range; 5 could not be searched.

- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status

[Full history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/user/action-items/post.md)

---

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