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

DELETE/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"
curl -s -X DELETE "https://<your-xebit-voicekit-host>/v1/calls/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: $XEBIT_API_KEY"

Delete with an inbound webhook

POST/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"
    }
  }'
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"
    }
  }'

Payload schema:

NameTypeRequiredDescription
actionstringYesMust be "call.delete".
data.call_idstringYesThe call_id of the call to delete.

Response

200 OK

JSON
{
  "data": {
    "call_id": "550e8400-e29b-41d4-a716-446655440000",
    "deleted": true
  }
}

Error responses

StatusCodeCause
404 Not FoundNOT_FOUNDNo completed call with that call_id exists in your organisation.
401 UnauthorizedUNAUTHORIZEDThe API key or webhook token is missing or invalid.
500 Internal Server ErrorINTERNAL_ERRORSomething failed on the server.

Cancel or delete

CancelDelete
Works onPending or scheduled callsCompleted calls with a recorded engagement
EffectStops the call from being dialledPermanently erases customer PII
Record kept?Yes, with status cancelledNo, the call data is removed
Reversible?No, but the data is keptNo

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.