curl -X DELETE https://api.bota.dev/v1/end-users/eu_abc123 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch('https://api.bota.dev/v1/end-users/eu_abc123', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer sk_live_...',
},
});
// 204 No Content on success
import requests
response = requests.delete(
'https://api.bota.dev/v1/end-users/eu_abc123',
headers={
'Authorization': 'Bearer sk_live_...',
},
)
# 204 No Content on success
{
"error": {
"code": "not_found",
"message": "End user not found"
}
}
End Users
Delete End User
Delete an end user from active use
DELETE
/
end-users
/
{id}
curl -X DELETE https://api.bota.dev/v1/end-users/eu_abc123 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch('https://api.bota.dev/v1/end-users/eu_abc123', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer sk_live_...',
},
});
// 204 No Content on success
import requests
response = requests.delete(
'https://api.bota.dev/v1/end-users/eu_abc123',
headers={
'Authorization': 'Bearer sk_live_...',
},
)
# 204 No Content on success
{
"error": {
"code": "not_found",
"message": "End user not found"
}
}
Delete an end user from active use. The end user becomes read-only and cannot be recovered. Existing recordings and device associations remain available as historical data.
This endpoint does not erase retained recordings, transcripts, summaries, or audio objects. Do not treat it as completion of a GDPR or other permanent-data-erasure request.
Authentication
Requires an API key withend_users:write scope.
curl -X DELETE https://api.bota.dev/v1/end-users/eu_abc123 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch('https://api.bota.dev/v1/end-users/eu_abc123', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer sk_live_...',
},
});
// 204 No Content on success
import requests
response = requests.delete(
'https://api.bota.dev/v1/end-users/eu_abc123',
headers={
'Authorization': 'Bearer sk_live_...',
},
)
# 204 No Content on success
Path Parameters
string
required
The end user’s unique identifier (e.g.,
eu_abc123).Response
Returns204 No Content on success.
{
"error": {
"code": "not_found",
"message": "End user not found"
}
}
What Happens on Deletion
When you delete an end user, Bota applies the following lifecycle changes:| Resource | Action |
|---|---|
| End user record | Marked deleted and made read-only |
| External ID | Released for a new end user in the same project |
| Existing recordings | Retained |
| Existing transcriptions and summaries | Retained |
| Device associations | Retained as historical associations |
This operation cannot be undone through the API or Portal. Reusing the same
external_id creates a new end user with a different eu_* ID; it does not recover the deleted record.Was this page helpful?