Delete Operator
Permanently delete an operator and remove its virtual number assignments.
DELETE
https://api.identitycall.ai/api/v1/public/operators/:idDelete an operator. Cascades to virtual_number_operators (assignments only) — virtual numbers themselves are never deleted.
Requires write permission
This action is irreversible. The operator record and all of its virtual_number_operators rows (the join records that route calls to this operator) are permanently removed.
The virtual numbers themselves are not deleted — they remain on the account, but will no longer route to this operator.
Scope
| API key scope | Behavior |
|---|---|
| Account-wide | Can delete any operator in the account |
| Project-scoped | Returns 404 for operators not linked to the bound project |
Path Parameters
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | - | Operator ID |
Request
cURL
curl -X DELETE "https://api.identitycall.ai/api/v1/public/operators/42" \
-H "Authorization: Bearer $IDENTITYCALL_API_KEY"Response
Response200 OK
{
"success": true
}Cascade behavior
| Resource | Effect |
|---|---|
Operator | Hard-deleted |
virtual_number_operators (join rows) | Hard-deleted — the operator is removed from any virtual number routing list |
OperatorProject (project links) | Hard-deleted |
VirtualNumber | Untouched — virtual numbers remain on the account |
| Inbound calls in flight | Unaffected (the operator is no longer eligible for new routings) |
Errors
| Status | Error | Description |
|---|---|---|
| 401 | ”Invalid API key” | Missing or unrecognized bearer token |
| 403 | ”Write permission required” | API key lacks write permission |
| 404 | ”Resource not found” | Operator doesn’t exist, or (for project-scoped keys) is not linked to the bound project |