Delete agent - Mnemom Docs

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

string

required

The agent ID to delete (e.g., mnm-a1b2c3d4-...)

Response

string

Unique identifier for tracking the deletion request

string

Current cascade status: tombstoned, phase_N_complete, kv_cleared, pseudonymized, complete, or failed

string

ISO 8601 timestamp of when the deletion was requested

Status codes

Code	Meaning
`202`	Deletion accepted — agent tombstoned, cascade in progress
`401`	Authentication required
`403`	Access denied — you do not own this agent
`404`	Agent 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

const response = await fetch(
  `https://api.mnemom.ai/v1/agents/${agentId}`,
  {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${apiKey}` },
  }
);
const { deletion_request_id, status } = await response.json();

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.

​DELETE /v1/agents/

​Authentication

​Parameters

​Response

​Status codes

​Idempotency

​Example

​What gets deleted

​Tracking deletion progress

DELETE /v1/agents/

Authentication

Parameters

Response

Status codes

Idempotency

Example

What gets deleted

Tracking deletion progress