Delete a Call

Permanently delete a call and optionally its associated storage files.

This action cannot be undone. All call data including transcripts, analysis results, and scorecard evaluations will be permanently deleted.

Request

curl -X DELETE "https://api.chanl.ai/api/v1/calls/695d6957e21c0ceb325c394d" \
  -H "Authorization: Bearer <access_token>"

const response = await fetch(`https://api.chanl.ai/api/v1/calls/${callId}`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer ' + accessToken
  }
});

const { success } = await response.json();
console.log('Deleted:', success);

import requests

response = requests.delete(
    f'https://api.chanl.ai/api/v1/calls/{call_id}',
    headers={'Authorization': f'Bearer {access_token}'}
)

result = response.json()

Response

{
  "success": true,
  "data": {
    "deleted": true,
    "callId": "695d6957e21c0ceb325c394d"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Call not found"
  }
}

Path Parameters

idstringrequired

The unique identifier of the call to delete.

What Gets Deleted

When you delete a call, the following data is permanently removed:

Call record and metadata
Associated transcript
Analysis results (summary, sentiment, topics, etc.)
Scorecard evaluation results
Extracted data
Storage files (audio recordings, if applicable)

Bulk Delete

For deleting multiple calls at once, use the bulk delete endpoint:

curl -X POST "https://api.chanl.ai/api/v1/calls/bulk-delete" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "callIds": [
      "695d6957e21c0ceb325c394d",
      "695d6957e21c0ceb325c394e",
      "695d6957e21c0ceb325c394f"
    ],
    "deleteStorageFiles": true
  }'

const response = await fetch('https://api.chanl.ai/api/v1/calls/bulk-delete', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    callIds: [
      '695d6957e21c0ceb325c394d',
      '695d6957e21c0ceb325c394e',
      '695d6957e21c0ceb325c394f'
    ],
    deleteStorageFiles: true
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.chanl.ai/api/v1/calls/bulk-delete',
    headers={'Authorization': f'Bearer {access_token}'},
    json={
        'callIds': [
            '695d6957e21c0ceb325c394d',
            '695d6957e21c0ceb325c394e',
            '695d6957e21c0ceb325c394f'
        ],
        'deleteStorageFiles': True
    }
)

data = response.json()

Response:

{
  "success": true,
  "data": {
    "deletedCount": 3,
    "storageFilesDeleted": 2
  }
}

Bulk Delete Parameters

callIdsarrayrequired

Array of call IDs to delete (max 100).

deleteStorageFilesbooleandefault: true

Whether to also delete associated audio files from storage.

Path Parameters

What Gets Deleted

Bulk Delete

Bulk Delete Parameters

On this page