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"
}
Users
Delete User
Permanently delete a user and their associated voiceprint data. Irreversible. Use for GDPR right-to-erasure requests.
DELETE
/
organisations
/
{orgId}
/
users
/
{userId}
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"
}
Overview
Permanently removes a user record and all associated voiceprint data from Voxmind’s systems. This action cannot be undone. After deletion, theexternal_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.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"
}