Skip to main content
POST
/
api
/
v1
/
memories
Store single group chat message memory
curl --request POST \
  --url https://api.example.com/api/v1/memories \
  --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"
  ],
  "sender": "user_001",
  "sender_name": "John"
}
EOF
{
  "status": "ok",
  "message": "Extracted 1 memories",
  "result": {
    "saved_memories": [
      {
        "memory_type": "episode_memory",
        "user_id": "user_001",
        "group_id": "group_123",
        "timestamp": "2025-01-15T10:00:00",
        "content": "User discussed the technical solution for the new feature"
      }
    ],
    "count": 1,
    "status_info": "extracted"
  }
}

Body

application/json

Store single message request body

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"

​
refer_list
string[] | null

List of referenced message IDs

Example:
["msg_000"]

Response

Successfully stored memory data

The response is of type Response Memorize Single Message Api V1 Memories Post · object.