Skip to main content
Mastra v1 is coming in January 2026. Get ahead by starting new projects with the beta or upgrade your existing project today.

Memory.deleteMessages()

The .deleteMessages() method deletes multiple messages by their IDs.

Usage ExampleDirect link to Usage Example

await memory?.deleteMessages(["671ae63f-3a91-4082-a907-fe7de78e10ec"]);

ParametersDirect link to Parameters

messageIds:

string[]
Array of message IDs to delete

ReturnsDirect link to Returns

void:

Promise<void>
A promise that resolves when all messages are deleted

Extended usage exampleDirect link to Extended usage example

src/test-memory.ts
import { mastra } from "./mastra";
import { UIMessageWithMetadata } from "@mastra/core/agent";

const agent = mastra.getAgent("agent");
const memory = await agent.getMemory();

const { uiMessages } = await memory!.query({ threadId: "thread-123" });

const messageIds = uiMessages.map(
(message: UIMessageWithMetadata) => message.id,
);
await memory?.deleteMessages([...messageIds]);

On this page