Agents

Tombstone (reversible soft-delete) an agent

Soft-deletes an agent: sets deleted_at so it disappears from the org fleet/dashboard while KEEPING all data (traces, checkpoints, proofs) for audit. Reversible via POST /v1/agents/{agent_id}/restore. Distinct from DELETE /v1/agents/{agent_id}, which is the irreversible GDPR Art.17 erasure cascade. Authorized for an org owner/admin of the agent's org OR the agent's own 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. Idempotent: tombstoning an already-tombstoned agent returns 200.

post/agents/{agent_id}/tombstone

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/agents/{agent_id}/tombstone
  • 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

Agent tombstoned (or already tombstoned)

idstring required
deleted_atstring date-time nullable
tombstonedboolean required

Changes

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