Deleting Calls
Permanently erase a completed call and the customer's personal data with DELETE /v1/calls/{call_id} or the call.delete webhook action.
Showing instructions for Xebit VoiceCloud.Showing instructions for Xebit VoiceKit, on your own infrastructure. Switch with the selector at the top. Updated 22 October 2026.
Deleting a call permanently removes the end customer's personal data held for that call: transcript, recording metadata and contact details. It is a data erasure operation for completed calls, and is not the same as cancelling, which only stops a pending call from being dialled.
Deletion cannot be undone. Transcripts, analytics and contact details are gone for good once the request succeeds.
Delete with the REST API
/v1/calls/{call_id}Requires an API key with the calls:delete scope, sent as x-api-key.
curl -s -X DELETE "https://api.voice.xebit.ai/v1/calls/550e8400-e29b-41d4-a716-446655440000" \
-H "x-api-key: $XEBIT_API_KEY"import os
import requests
BASE_URL = "https://api.voice.xebit.ai/v1"
API_KEY = os.environ["XEBIT_API_KEY"]
call_id = "550e8400-e29b-41d4-a716-446655440000"
response = requests.delete(
f"{BASE_URL}/calls/{call_id}",
headers={"x-api-key": API_KEY}
)
print(response.status_code, response.json())const BASE_URL = "https://api.voice.xebit.ai/v1";
const API_KEY = process.env.XEBIT_API_KEY;
const callId = "550e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`${BASE_URL}/calls/${callId}`, {
method: "DELETE",
headers: { "x-api-key": API_KEY }
});
console.log(response.status, await response.json());curl -s -X DELETE "https://<your-xebit-voicekit-host>/v1/calls/550e8400-e29b-41d4-a716-446655440000" \
-H "x-api-key: $XEBIT_API_KEY"import os
import requests
BASE_URL = "https://<your-xebit-voicekit-host>/v1"
API_KEY = os.environ["XEBIT_API_KEY"]
call_id = "550e8400-e29b-41d4-a716-446655440000"
response = requests.delete(
f"{BASE_URL}/calls/{call_id}",
headers={"x-api-key": API_KEY}
)
print(response.status_code, response.json())const BASE_URL = "https://<your-xebit-voicekit-host>/v1";
const API_KEY = process.env.XEBIT_API_KEY;
const callId = "550e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`${BASE_URL}/calls/${callId}`, {
method: "DELETE",
headers: { "x-api-key": API_KEY }
});
console.log(response.status, await response.json());Delete with an inbound webhook
/v1/hooks/{YOUR_WEBHOOK_TOKEN}Send the call.delete action to your inbound webhook URL.
curl -s -X POST "https://api.voice.xebit.ai/v1/hooks/YOUR_WEBHOOK_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"action": "call.delete",
"data": {
"call_id": "550e8400-e29b-41d4-a716-446655440000"
}
}'import os
import requests
BASE_URL = "https://api.voice.xebit.ai/v1"
token = "YOUR_WEBHOOK_TOKEN"
response = requests.post(
f"{BASE_URL}/hooks/{token}",
json={
"action": "call.delete",
"data": {
"call_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
)
print(response.status_code, response.json())const BASE_URL = "https://api.voice.xebit.ai/v1";
const token = "YOUR_WEBHOOK_TOKEN";
const response = await fetch(`${BASE_URL}/hooks/${token}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
action: "call.delete",
data: {
call_id: "550e8400-e29b-41d4-a716-446655440000"
}
})
});
console.log(response.status, await response.json());curl -s -X POST "https://<your-xebit-voicekit-host>/v1/hooks/YOUR_WEBHOOK_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"action": "call.delete",
"data": {
"call_id": "550e8400-e29b-41d4-a716-446655440000"
}
}'import os
import requests
BASE_URL = "https://<your-xebit-voicekit-host>/v1"
token = "YOUR_WEBHOOK_TOKEN"
response = requests.post(
f"{BASE_URL}/hooks/{token}",
json={
"action": "call.delete",
"data": {
"call_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
)
print(response.status_code, response.json())const BASE_URL = "https://<your-xebit-voicekit-host>/v1";
const token = "YOUR_WEBHOOK_TOKEN";
const response = await fetch(`${BASE_URL}/hooks/${token}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
action: "call.delete",
data: {
call_id: "550e8400-e29b-41d4-a716-446655440000"
}
})
});
console.log(response.status, await response.json());Payload schema:
| Name | Type | Required | Description |
|---|---|---|---|
action | string | Yes | Must be "call.delete". |
data.call_id | string | Yes | The call_id of the call to delete. |
Response
200 OK
{
"data": {
"call_id": "550e8400-e29b-41d4-a716-446655440000",
"deleted": true
}
}Error responses
| Status | Code | Cause |
|---|---|---|
404 Not Found | NOT_FOUND | No completed call with that call_id exists in your organisation. |
401 Unauthorized | UNAUTHORIZED | The API key or webhook token is missing or invalid. |
500 Internal Server Error | INTERNAL_ERROR | Something failed on the server. |
Cancel or delete
| Cancel | Delete | |
|---|---|---|
| Works on | Pending or scheduled calls | Completed calls with a recorded engagement |
| Effect | Stops the call from being dialled | Permanently erases customer PII |
| Record kept? | Yes, with status cancelled | No, the call data is removed |
| Reversible? | No, but the data is kept | No |
On Xebit VoiceCloud, deletion removes the data from Xebit's platform storage, recordings and transcripts included.
On Xebit VoiceKit, deletion removes the data from your deployment's own databases and object storage. Backups and snapshots your team keeps outside Xebit VoiceKit are governed by your own retention policy.