Delete End User

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

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.

Authentication

Requires an API key with end_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

Returns 204 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.

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.

Overview

End Users

Devices

Recordings

Uploads

AI Ask

AI Processing

Resources

Delete End User

Authentication

Path Parameters

Response

What Happens on Deletion

​Authentication

​Path Parameters

​Response

​What Happens on Deletion

Authentication

Path Parameters

Response

What Happens on Deletion