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>"
}
'
{
  "_id": "<string>",
  "entity_id": "<string>",
  "created": "<string>",
  "updated": "<string>",
  "store_id": "<string>",
  "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).

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9]+(?:[_-][A-Za-z0-9]+)*$

Response

Memory successfully created.

​
_id
string
required

Unique identifier for the memory. This is automatically generated by the system.

​
entity_id
string
required
deprecated

Customer provided entity ID for the memory. This is used to link the memory to a specific user/company/session/etc. Has to be unique within the memory store.

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9]+(?:[_-][A-Za-z0-9]+)*$
​
created
string
required
​
updated
string
required
​
store_id
string
required
​
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