Skip to main content
POST
/
api
/
v0
/
memories
Python
# To use the Python SDK, install the package:
# pip install evermemos

from evermemos import EverMemOS

memory = EverMemOS(api_key="<api_key>").v0.memories

response = memory.add(
    message_id="<message_id>",
    create_time="<iso8601_time>",
    sender="<user_id>",
    content="<message_content>"
)
print(response.status, response.request_id)
{
  "status": "queued",
  "message": "Message accepted and queued for processing",
  "request_id": "xxxx"
}

Authorizations

​
Authorization
string
header
default:Bearer <api_key>
required

Bearer authentication header of the form Bearer 'api_key', where 'api_key' is your EverMemOS auth api key.

Body

application/json
​
message_id
string
required

Message unique identifier

Example:

"msg_001"

​
create_time
string
required

Message creation time (ISO 8601 format with Timezone is required)

Example:

"2025-01-15T10:00:00+00:00"

​
sender
string
required

Sender user ID (required). Also used as user_id internally for memory ownership.

Example:

"user_001"

​
content
string
required

Message content

Example:

"Let's discuss the technical solution for the new feature today"

​
group_id
string | null

Group ID. If not provided, will automatically generate based on hash(sender) + '_group' suffix, representing single-user mode where each user's messages are extracted into separate memory spaces.

Example:

"group_123"

​
group_name
string | null

Group name

Example:

"Project Discussion Group"

​
sender_name
string | null

Sender name (uses sender if not provided)

Example:

"John"

​
role
string | null

Message sender role, used to identify the source of the message. Enum values from MessageSenderRole:

  • user: Message from a human user
  • assistant: Message from an AI assistant
Example:

"user"

​
refer_list
string[] | null

List of referenced message IDs

Example:
["msg_000"]
​
flush
boolean
default:false

Force boundary trigger. When True, immediately triggers memory extraction instead of waiting for natural boundary detection.

Examples:

false

true

Response

Successful Response

​
status
string
required
​
message
string
required
​
request_id
string
required