Use the Memory block to store and retrieve messages across workflow runs. Add messages with the same conversation identifier to append to an existing conversation, retrieve one conversation or all memories, and delete memories that are no longer needed.
Integrate Memory into the workflow. Can add, get a memory, get all memories, and delete memories.
Add a new memory to the database or append to existing memory with the same ID.
| Parameter | Type | Required | Description |
|---|
conversationId | string | No | Conversation identifier (e.g., user-123, session-abc). If a memory with this conversationId already exists, the new message will be appended to it. |
id | string | No | Legacy parameter for conversation identifier. Use conversationId instead. Provided for backwards compatibility. |
role | string | Yes | Role for agent memory (user, assistant, or system) |
content | string | Yes | Content for agent memory |
| Parameter | Type | Description |
|---|
success | boolean | Whether the memory was added successfully |
memories | array | Array of memory objects including the new or updated memory |
error | string | Error message if operation failed |
Retrieve memory by conversationId. Returns matching memories.
| Parameter | Type | Required | Description |
|---|
conversationId | string | No | Conversation identifier (e.g., user-123, session-abc). Returns memories for this conversation. |
id | string | No | Legacy parameter for conversation identifier. Use conversationId instead. Provided for backwards compatibility. |
| Parameter | Type | Description |
|---|
success | boolean | Whether the memory was retrieved successfully |
memories | array | Array of memory objects with conversationId and data fields |
message | string | Success or error message |
error | string | Error message if operation failed |
Retrieve all memories from the database
| Parameter | Type | Required | Description |
|---|
| Parameter | Type | Description |
|---|
success | boolean | Whether all memories were retrieved successfully |
memories | array | Array of all memory objects with key, conversationId, and data fields |
message | string | Success or error message |
error | string | Error message if operation failed |
Delete memories by conversationId.
| Parameter | Type | Required | Description |
|---|
conversationId | string | No | Conversation identifier (e.g., user-123, session-abc). Deletes all memories for this conversation. |
id | string | No | Legacy parameter for conversation identifier. Use conversationId instead. Provided for backwards compatibility. |
| Parameter | Type | Description |
|---|
success | boolean | Whether the memory was deleted successfully |
message | string | Success or error message |
error | string | Error message if operation failed |