Skip to main content
POST
/
v1
/
dev
/
user
/
memories
Create memory
curl --request POST \
  --url https://api.omi.me/v1/dev/user/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "User prefers dark mode in all applications",
  "category": "system",
  "tags": [
    "preferences",
    "ui"
  ]
}
'
{
  "id": "mem_xyz789",
  "content": "User prefers dark mode in all applications",
  "category": "system",
  "visibility": "private",
  "tags": [
    "preferences",
    "ui"
  ],
  "created_at": "2025-12-06T10:35:00Z",
  "updated_at": "2025-12-06T10:35:00Z",
  "manually_added": true
}

Authorizations

​
Authorization
string
header
required

Developer API key. Get one from Settings → Developer → Create Key in the Omi app. Keys are prefixed with omi_dev_.

Body

application/json
​
content
string
required

The memory content.

Required string length: 1 - 500
​
category
enum<string>

Memory category. Auto-categorized if not provided.

Available options:
interesting,
system,
manual
​
visibility
enum<string>
default:private

Visibility level.

Available options:
public,
private
​
tags
string[]

List of tags.

Response

The created memory.

​
id
string

Unique identifier.

​
content
string

The memory content.

​
category
enum<string>

Memory category.

Available options:
interesting,
system,
manual
​
visibility
enum<string>

Visibility level.

Available options:
public,
private
​
tags
string[]

List of tags.

​
created_at
string<date-time>

When the memory was created.

​
updated_at
string<date-time>

When the memory was last updated.

​
manually_added
boolean

Whether the memory was added manually (via API or app).

​
reviewed
boolean

Whether the memory has been reviewed.

​
user_review
boolean | null

User's review decision.

​
edited
boolean

Whether the memory has been edited.