---
title: "Create Memory"
method: POST
path: "/v1/dev/user/memories"
tags: ["Memories"]
---

# Create Memory

`POST /v1/dev/user/memories`

Create a new memory for the authenticated user.

- **content**: The content of the memory (1-500 characters)
- **category**: Memory category (auto-categorized if not provided)
- **visibility**: Visibility: public or private (default: private)
- **tags**: List of tags associated with the memory

## Request body

- CreateMemoryRequest
  - `category` 'interesting' | 'system' | 'manual' | 'workflow' | 'core' | 'hobbies' | 'lifestyle' | 'interests' | 'habits' | 'work' | 'skills' | 'learnings' | 'other' | 'auto'
  - `content` string, required — The content of the memory
  - `tags` string[] — Tags associated with the memory
  - `visibility` string — Visibility: public or private

## Response `200`

Successful Response

- DeveloperMemory
  - `category` 'interesting' | 'system' | 'manual' | 'workflow' | 'core' | 'hobbies' | 'lifestyle' | 'interests' | 'habits' | 'work' | 'skills' | 'learnings' | 'other' | 'auto'
  - `content` string
  - `created_at` string, date-time, nullable
  - `edited` boolean
  - `id` string, required
  - `manually_added` boolean
  - `reviewed` boolean
  - `scoring` string, nullable
  - `tags` string[]
  - `updated_at` string, date-time, nullable
  - `user_review` boolean, nullable
  - `visibility` string, 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/memories/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)