Link Search Menu Expand Document Documentation Menu

Create or update a memory

Introduced 2.12

Use this API to create or update a conversational memory for conversational search. A memory stores conversation history for the current conversation.

Once a memory is created, you’ll provide its memory_id to other APIs.

The POST method creates a new memory. The PUT method updates an existing memory.

When the Security plugin is enabled, all memories exist in a private security mode. Only the user who created a memory can interact with that memory and its messages.

Path and HTTP methods

POST /_plugins/_ml/memory/
PUT /_plugins/_ml/memory/<memory_id>

Path parameters

The following table lists the available path parameters.

Parameter Data type Description
memory_id String The ID of the memory to be updated. Required for the PUT method.

Request body fields

The following table lists the available request fields.

Field Data type Required/Optional Description
name String Optional The name of the memory.

Example request

POST /_plugins/_ml/memory/
{
  "name": "Conversation for a RAG pipeline"
}

Example response

{
  "memory_id": "gW8Aa40BfUsSoeNTvOKI"
}
350 characters left

Have a question? .

Want to contribute? or .