API referenceContacts
Erase a contact (GDPR)
DELETE
IRREVERSIBLE: erases the contact’s personal data, identities and message contents. Needs a key whose member may erase contacts (Owner or Admin). ?reason= is recorded in the audit log.
ApiKeyheader
AuthorizationBearer <token>An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).
id*stringThe contact id.
Format
uuidreason?stringWhy (kept in the audit log).
Gauge-Version?stringA dated version. Default 2026-10-21.
What was erased.
application/json- response
id*stringFormat
uuiderased*trueValue in
trueerasedAt*stringidentitiesDeleted*integermessagesRedacted*integercurl -X DELETE 'https://app.gauge.chat/api/v2/contacts/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "erased": true, "erasedAt": "string", "identitiesDeleted": 0, "messagesRedacted": 0}