Skip to main content
POST
/
api
/
v1
/
memories
Add memories
curl --request POST \
  --url https://api.evermind.ai/api/v1/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "content": "Let's discuss the technical solution for the new feature today",
  "create_time": "2025-01-15T10:00:00+00:00",
  "group_id": "group_123",
  "group_name": "Project Discussion Group",
  "message_id": "msg_001",
  "refer_list": [
    "msg_000"
  ],
  "role": "user",
  "sender": "user_001",
  "sender_name": "John"
}
EOF
{
  "status": "ok",
  "message": "",
  "result": {
    "saved_memories": [
      "<unknown>"
    ],
    "count": 0,
    "status_info": "accumulated"
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Store single message request body (HTTP API layer)

Used for POST /api/v1/memories endpoint

​
message_id
string
required

Message unique identifier

Example:

"msg_001"

​
create_time
string
required

Message creation time (ISO 8601 format)

Example:

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

​
sender
string
required

Sender user ID

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

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"]

Response

Successful Response

Memory storage response

Response for POST /api/v1/memories endpoint.

​
status
string
default:ok

Response status

Examples:

"ok"

"failed"

​
message
string
default:""

Response message

Example:

"Operation successful"

​
result
MemorizeResult · object

Memory storage result

Examples:
{
  "summary": "Extracted memories (boundary triggered)",
  "value": {
    "count": 1,
    "saved_memories": [],
    "status_info": "extracted"
  }
}
{
  "summary": "Message queued (boundary not triggered)",
  "value": {
    "count": 0,
    "saved_memories": [],
    "status_info": "accumulated"
  }
}