POST
/
mcp
/
add_session_memory
Tool: Add Memory (Self-Contained)
curl --request POST \
  --url http://localhost:8080/v1/mcp/add_session_memory \
  --header 'Content-Type: application/json' \
  --data '{
  "session": {
    "group_id": "<string>",
    "agent_id": [
      "<string>"
    ],
    "user_id": [
      "<string>"
    ],
    "session_id": "<string>"
  },
  "producer": "<string>",
  "produced_for": "<string>",
  "episode_content": "<string>",
  "episode_type": "<string>",
  "metadata": {}
}'
{
  "status": 123,
  "error_msg": "<string>"
}

Body

application/json

Data model for adding a new memory episode.

session
object
required

The session context for the episode.

producer
string
required

The ID of the entity that produced the content.

produced_for
string
required

The ID of the entity the content was produced for.

episode_content
required

The content, either as raw text or an embedding vector.

episode_type
string
required

The type of content (e.g., 'dialog', 'summary').

metadata
object | null

Optional arbitrary metadata.

Response

200 - application/json

Status 0 if the memory was added successfully.

status
integer
required

Status code (0 for success).

error_msg
string
required

Error message if status is non-zero.