Delete User

# Typical GDPR erasure workflow: # 1. Find the Voxmind user ID from your external_id resp = requests.get( "https://api.voxmind.ai/organisations/42/users", headers={"Authorization": "Bearer YOUR_API_TOKEN"}, params={"filter": "external_id=user_98765"}, ) voxmind_id = resp.json()["results"][0]["id"] # 2. Delete the record (voiceprint included) resp = requests.delete( f"https://api.voxmind.ai/organisations/42/users/{voxmind_id}", headers={"Authorization": "Bearer YOUR_API_TOKEN"}, ) # 200 = permanently deleted

Overview

Permanently removes a user record and all associated voiceprint data from Voxmind’s systems. This action cannot be undone. After deletion, the external_id is free to be re-enrolled as a new user if needed.

Deletion is permanent and includes the voiceprint. If you only want to prevent a user from authenticating temporarily, use the Update User endpoint to set is_active: false instead. Reserve deletion for permanent removal scenarios.

The primary use case for deletion is fulfilling GDPR right-to-erasure requests — when a user requests that your platform delete all data associated with them, this endpoint ensures Voxmind’s copy of their biometric data is also removed.

Path Parameters

string

required

Your organisation’s unique identifier.

string

required

Voxmind’s internal numeric ID for the user to permanently delete.

curl -X DELETE https://api.voxmind.ai/organisations/42/users/1001 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

# Typical GDPR erasure workflow:
# 1. Find the Voxmind user ID from your external_id
resp = requests.get(
    "https://api.voxmind.ai/organisations/42/users",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
    params={"filter": "external_id=user_98765"},
)
voxmind_id = resp.json()["results"][0]["id"]

# 2. Delete the record (voiceprint included)
resp = requests.delete(
    f"https://api.voxmind.ai/organisations/42/users/{voxmind_id}",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
# 200 = permanently deleted

{
  "id": 1001,
  "org_id": 42,
  "external_id": "user_98765",
  "is_active": false,
  "created_at": "2025-02-10T09:15:00Z",
  "updated_at": "2025-03-15T14:00:00Z"
}

Voice Core

API Tokens

Organisation

Users

Billing

Devices & Texts

Overview

Path Parameters

​Overview

​Path Parameters

Overview

Path Parameters