Skip to main content

​
DELETE /v1/agents/

Permanently deletes an agent and cascades deletion across all associated data stores. Returns 202 Accepted — the agent is immediately inaccessible and data deletion proceeds asynchronously. This operation is irreversible. Once the cascade completes, the agent and all associated data cannot be recovered.

​
Authentication

Requires a valid JWT or API key with ownership of the agent.

​
Parameters

​
agent_id
string
required
The agent ID to delete (e.g., mnm-a1b2c3d4-...)

​
Response

​
deletion_request_id
string
Unique identifier for tracking the deletion request
​
status
string
Current cascade status: tombstoned, phase_N_complete, kv_cleared, pseudonymized, complete, or failed
​
requested_at
string
ISO 8601 timestamp of when the deletion was requested

​
Status codes

CodeMeaning
202Deletion accepted — agent tombstoned, cascade in progress
401Authentication required
403Access denied — you do not own this agent
404Agent not found

​
Idempotency

Repeated DELETE requests for the same agent return 202 with the existing deletion request. The operation is safe to retry.

​
Example

curl -X DELETE \
  -H "Authorization: Bearer $API_KEY" \
  https://api.mnemom.ai/v1/agents/mnm-a1b2c3d4-5678-90ab-cdef-1234567890ab
Response (202)
{
  "deletion_request_id": "dr-a1b2c3d4-...",
  "status": "tombstoned",
  "requested_at": "2026-04-16T14:30:00.000Z"
}

​
What gets deleted

See GDPR Data Subject Rights for the complete inventory of deleted, pseudonymized, and retained data.

​
Tracking deletion progress

Use GET /v1/agents/{agent_id}/deletion-status to monitor cascade progress.