Get deletion status - Mnemom Docs

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

string

required

The agent ID to check deletion status for

Response

string

Unique identifier of the deletion request

string

Current cascade phase. Values: tombstoned, phase_1_complete through phase_7_complete, kv_cleared, pseudonymized, complete, failed

string

ISO 8601 timestamp of the deletion request

string | null

ISO 8601 timestamp of cascade completion, or null if still in progress

string | null

Phase where the cascade failed, or null if no failure

number

Number of retry attempts for a failed cascade

Status codes

Code	Meaning
`200`	Deletion request found
`401`	Authentication required
`404`	No 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
}

Cascade phase reference

For a description of what each status value represents and what data is removed at each step, see Cascade phase breakdown in the GDPR Data Subject Rights guide.

​GET /v1/agents//deletion-status

​Authentication

​Parameters

​Response

​Status codes

​Example

​Cascade phase reference

GET /v1/agents//deletion-status

Authentication

Parameters

Response

Status codes

Example

Cascade phase reference