curl -X DELETE \
"http://localhost:8000/api/v2/agents/my-agent/memories/b7c3cf31-e537-49f1-abc4-c50ac6adeac5" \
-H "X-Session-Token: your_session_token"
{
"agent_id": "my-agent",
"memory_id": "b7c3cf31-e537-49f1-abc4-c50ac6adeac5",
"namespace": "memanto_agent_my-agent",
"status": "deleted"
}
{
"detail": "Memory 'b7c3cf31-e537-49f1-abc4-c50ac6adeac5' was not found for agent 'my-agent'"
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Data
Delete Memory
Delete a single memory from the active agent’s namespace.
DELETE
/
api
/
v2
/
agents
/
{agent_id}
/
memories
/
{memory_id}
curl -X DELETE \
"http://localhost:8000/api/v2/agents/my-agent/memories/b7c3cf31-e537-49f1-abc4-c50ac6adeac5" \
-H "X-Session-Token: your_session_token"
{
"agent_id": "my-agent",
"memory_id": "b7c3cf31-e537-49f1-abc4-c50ac6adeac5",
"namespace": "memanto_agent_my-agent",
"status": "deleted"
}
{
"detail": "Memory 'b7c3cf31-e537-49f1-abc4-c50ac6adeac5' was not found for agent 'my-agent'"
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Overview
Permanently deletes one memory from the agent’s Moorcheh namespace, scoped by the active session. The session must belong to the agent named in the path.This cannot be undone. To retire a memory reversibly — keeping its content and
leaving it recallable — use Expire Memory.
Authentication
API clients do not send an API key orAuthorization header.
string
required
Session token from Activate Agent. Must match
agent_id.Path Parameters
string
required
The unique identifier of the agent.
string
required
The ID of the memory to delete.
curl -X DELETE \
"http://localhost:8000/api/v2/agents/my-agent/memories/b7c3cf31-e537-49f1-abc4-c50ac6adeac5" \
-H "X-Session-Token: your_session_token"
{
"agent_id": "my-agent",
"memory_id": "b7c3cf31-e537-49f1-abc4-c50ac6adeac5",
"namespace": "memanto_agent_my-agent",
"status": "deleted"
}
{
"detail": "Memory 'b7c3cf31-e537-49f1-abc4-c50ac6adeac5' was not found for agent 'my-agent'"
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Next Steps
- Recall to find a memory’s ID before deleting it
- Remember to store a new memory
- Expire Memory for the reversible alternative