> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Memories Matching • AI Agent SDK

> delete_memories_matching: Delete memories matching a search query.

# delete\_memories\_matching

<div className="flex items-center gap-2">
  <Badge color="purple">Method</Badge>
</div>

> This is a method of the [**Memory**](../classes/Memory) class in the [**memory**](../modules/memory) module.

Delete memories matching a search query.

Useful for bulk cleanup of related memories, e.g., all image-related
context after finishing an image analysis session.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def delete_memories_matching(query: str, memory_type: Optional[str], limit: int) -> int
```

## Parameters

<ParamField query="query" type="str" required={true}>
  Search query to match memories
</ParamField>

<ParamField query="memory_type" type="Optional" required={false}>
  Optional type ('short\_term' or 'long\_term')
</ParamField>

<ParamField query="limit" type="int" required={false} default="10">
  Maximum number of memories to delete
</ParamField>

### Returns

<ResponseField name="Returns" type="int">
  Number of memories deleted
</ResponseField>

## Uses

* `search_short_term`
* `delete_short_term`
* `search_long_term`
* `delete_long_term`

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/memory/memory.py#L1234">
  `praisonaiagents/memory/memory.py` at line 1234
</Card>