Back to Mastra

Reference: Memory.deleteMessages() | Memory

docs/src/content/en/reference/memory/deleteMessages.mdx

2025-12-181.1 KB
Original Source

Memory.deleteMessages()

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

Usage example

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

Parameters

<PropertiesTable content={[ { name: 'messageIds', type: 'string[]', description: 'Array of message IDs to delete', isOptional: false, }, ]} />

Returns

<PropertiesTable content={[ { name: 'void', type: 'Promise<void>', description: 'A promise that resolves when all messages are deleted', }, ]} />

Extended usage example

typescript
import { mastra } from './mastra'
import { MastraDBMessage } from '@mastra/core'

const agent = mastra.getAgent('agent')
const memory = await agent.getMemory()

const { messages } = await memory!.recall({ threadId: 'thread-123' })

const messageIds = messages.map((message: MastraDBMessage) => message.id)
await memory?.deleteMessages([...messageIds])