Skip to main content
POST
/
v2
/
memory-stores
/
{memory_store_key}
/
memories
Create a new memory
curl --request POST \
  --url https://api.orq.ai/v2/memory-stores/{memory_store_key}/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entity_id": "<string>",
  "metadata": {}
}
'
{
  "_id": "<string>",
  "entity_id": "<string>",
  "created": "<string>",
  "updated": "<string>",
  "store_id": "<string>",
  "metadata": {},
  "workspace_id": "<string>",
  "documents_count": 123,
  "created_by_id": "<string>",
  "updated_by_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
memory_store_key
string
required

The unique key identifier of the memory store

Body

application/json
​
entity_id
string
required

Unique identifier for the entity this memory is associated with (e.g., user ID, session ID, conversation ID). Must be a valid UUID or ULID.

​
metadata
object

Flexible key-value pairs for custom filtering and categorization. Clients can add arbitrary string metadata to enable future filtering of memory access based on their specific needs (e.g., user segments, topics, contexts, or any custom taxonomy).

Response

Memory successfully created.

​
_id
string
required
​
entity_id
string
required
​
created
string
required
​
updated
string
required
​
store_id
string
required
​
metadata
object
required

Flexible key-value pairs for custom filtering and categorization. Clients can add arbitrary string metadata to enable future filtering of memory access based on their specific needs (e.g., user segments, topics, contexts, or any custom taxonomy).

​
workspace_id
string
required
​
documents_count
number
required

The number of memories in the entity

​
created_by_id
string | null
​
updated_by_id
string | null