Delete a Scorecard
Permanently delete a scorecard and all its categories and criteria.
This action cannot be undone. Historical evaluation results that reference this scorecard will retain their scores, but the scorecard configuration will no longer be available.
Request
curl -X DELETE "https://api.chanl.ai/api/v1/scorecards/scorecard_abc123" \
-H "Authorization: Bearer <access_token>"const response = await fetch(`https://api.chanl.ai/api/v1/scorecards/${scorecardId}`, {
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/scorecards/{scorecard_id}',
headers={'Authorization': f'Bearer {access_token}'}
)
result = response.json()Response
{
"success": true,
"data": {
"deleted": true,
"scorecardId": "scorecard_abc123"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Scorecard not found"
}
}Path Parameters
idstringrequiredThe unique identifier of the scorecard to delete.
What Gets Deleted
When you delete a scorecard:
| Item | Deleted |
|---|---|
| Scorecard record | Yes |
| Categories | Yes |
| Criteria | Yes |
| Historical evaluation results | No (preserved) |
| Linked calls | No (preserved) |
Before Deleting
Consider these alternatives:
Deactivate Instead
Set the scorecard to inactive to preserve it while preventing new evaluations:
PATCH /api/v1/scorecards/{id}
{ "status": "inactive" }Archive with Draft
Set to draft status to hide from active use:
PATCH /api/v1/scorecards/{id}
{ "status": "draft" }If the scorecard is being used for ongoing evaluations, deactivating it is usually preferred over deletion. This preserves the configuration for reference.