Skip to main content
DELETE
/
api
/
v2
/
agents
/
{agent_id}
curl -X DELETE "http://localhost:8000/api/v2/agents/old-agent"

{
  "message": "Agent 'old-agent' successfully deleted (backup retained in Moorcheh)"
}

​
Overview

Removes the agent record from Memanto’s local store. By default, memories remain in Moorcheh under that agent’s namespace. Pass delete-backup-too=true to also delete the namespace and its contents in Moorcheh.
Without delete-backup-too=true, only local agent metadata is removed; the cloud namespace is left intact.

​
Authentication

API clients do not send an API key or Authorization header.

​
Path Parameters

​
agent_id
string
required
The unique identifier of the agent to delete.

​
Query Parameters

​
delete-backup-too
boolean
When true, also deletes the agent’s Moorcheh namespace (memanto_agent_{agent_id}) and its memories. When false or omitted, the namespace is not deleted. Accepts true or false.
curl -X DELETE "http://localhost:8000/api/v2/agents/old-agent"

{
  "message": "Agent 'old-agent' successfully deleted (backup retained in Moorcheh)"
}

​
Next Steps

After deleting an agent, you can: