v2

latestOpenAPI 3.1.02026-08-04642899.5 KB
clarity

Delete Data

Delete user's Clarity data (GDPR/compliance endpoint).

Permanently deletes the user's saved board. This cannot be undone. Requires confirm=true in request body to execute.

Headers: X-User-ID: User UUID (required) X-Internal-Secret: Internal API secret (required in production)

Body: confirm: bool (must be true to execute deletion)

Returns: 200: {"status": "deleted", "message": "...", "deleted": {"clarity_clusters": N}} 200: {"status": "no_data", "message": "..."} (idempotent - no data to delete) 400: Missing or false confirm parameter 401: Missing or malformed X-User-ID header 403: Invalid internal secret (production only) 404: User not found

Transaction Safety: Delete and audit log write happen in the SAME database transaction. If either fails, the entire transaction rolls back.

delete/api/clarity/data

Headers

X-Internal-Secretstring nullable
X-User-IDstring nullable

Request body

confirmboolean

Response

Successful Response

statusstring required
messagestring required
deletedobject nullable