DELETE /v1/agents/
Permanently deletes an agent and cascades deletion across all associated data stores. Returns202 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
Response
Current cascade status:
tombstoned, phase_N_complete, kv_cleared, pseudonymized, complete, or failedStatus codes
Idempotency
RepeatedDELETE requests for the same agent return 202 with the existing deletion request. The operation is safe to retry.
Example
Response (202)
What gets deleted
See GDPR Data Subject Rights for the complete inventory of deleted, pseudonymized, and retained data.Tracking deletion progress
UseGET /v1/agents/{agent_id}/deletion-status to monitor cascade progress.