Agents

Poll the status of a pending agent deletion

Returns the most-recent deletion_request row for the agent. Status progresses: tombstoned → phase_N_complete → kv_cleared → pseudonymized → complete (or failed at any phase). Used to track the async GDPR Art. 17 cascade kicked off by DELETE /agents/{agent_id}. See ADR-021.

Readable by members of the agent's org. Once the cascade has erased the agent, readable by the requester and by members of the org recorded on the request. Any other caller receives 404, the same as when no request exists.

get/agents/{agent_id}/deletion-status

Request

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

Path parameters

agent_idstring required

Agent identifier (e.g. smolt-abc123)

Response

Deletion request status.

deletion_request_idstring required
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
requested_atstring date-time required
completed_atstring date-time nullable
failed_phasestring nullable
failed_reasonstring nullable
retry_countinteger required

Changes

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