Skip to main content

​
GET /v1/agents//deletion-status

Returns the current status of a deletion request for an agent. Use this endpoint to verify that a deletion cascade has completed.

​
Authentication

Requires a valid JWT or API key.

​
Parameters

​
agent_id
string
required
The agent ID to check deletion status for

​
Response

​
deletion_request_id
string
Unique identifier of the deletion request
​
status
string
Current cascade phase. Values: tombstoned, phase_1_complete through phase_7_complete, kv_cleared, pseudonymized, complete, failed
​
requested_at
string
ISO 8601 timestamp of the deletion request
​
completed_at
string | null
ISO 8601 timestamp of cascade completion, or null if still in progress
​
failed_phase
string | null
Phase where the cascade failed, or null if no failure
​
retry_count
number
Number of retry attempts for a failed cascade

​
Status codes

CodeMeaning
200Deletion request found
401Authentication required
404No deletion request found for this agent

​
Example

cURL
curl -H "Authorization: Bearer $API_KEY" \
  https://api.mnemom.ai/v1/agents/mnm-a1b2c3d4-.../deletion-status
Response (200)
{
  "deletion_request_id": "dr-a1b2c3d4-...",
  "status": "complete",
  "requested_at": "2026-04-16T14:30:00.000Z",
  "completed_at": "2026-04-16T14:30:42.000Z",
  "failed_phase": null,
  "retry_count": 0
}