Agents

Delete agent (GDPR Art. 17 cascade)

Tombstone an agent and asynchronously cascade deletion across all agent-owned records (traces, integrity checkpoints, drift alerts, reclassifications, etc.) per ADR-021. The request returns 202 Accepted immediately with a deletion_request_id; poll GET /v1/agents/{agent_id}/deletion-status or subscribe to the deletion webhook for cascade progress.

Idempotent: re-DELETE on a tombstoned agent returns the existing deletion_request_id with the current status.

Authorized for an org owner/admin of the agent's org OR the agent's creator (while still a member of that org). A caller who is not a member of the agent's org gets the same 404 as a missing agent (no existence oracle); an org member who is neither owner/admin nor the creator gets 403.

delete/agents/{agent_id}

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/agents/{agent_id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Mnemom-Api-Key

Path parameters

agent_idstring required

Agent identifier (e.g. smolt-abc123)

Response

Deletion accepted; cascade will run asynchronously

deletion_request_idstring required

Stable identifier for this deletion request; pass to deletion-status to poll progress.

status'received' | 'tombstoned' | 'phase_1_complete' | 'phase_2_complete' | 'phase_3_complete' | 'phase_4_complete' | 'phase_5_complete' | 'phase_6_complete' | 'phase_7_complete' | 'kv_cleared' | 'pseudonymized' | 'complete' | 'failed' required

Initial state of a fresh delete is tombstoned (the synchronous part); the async cascade advances it through phase_1_complete … phase_7_complete → kv_cleared → pseudonymized → complete (or failed). An idempotent re-DELETE echoes the current status, so any of these may appear.

requested_atstring date-time required
completed_atstring date-time nullable

Set once the async cascade finishes. null while in flight.

Example response

{
  "deletion_request_id": "del-7f3b9e2a-c41d-4b8e-9f0a-d5c2e8a17b3e"
}

Changes

No recorded changes to this operation across all 1 revision of this API.