Skip to Content
API ReferenceOperatorsDelete Operator

Delete Operator

Permanently delete an operator and remove its virtual number assignments.

DELETEhttps://api.identitycall.ai/api/v1/public/operators/:id

Delete 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 scopeBehavior
Account-wideCan delete any operator in the account
Project-scopedReturns 404 for operators not linked to the bound project

Path Parameters

Parameters

NameTypeRequiredDefaultDescription
idintegerYes-Operator ID

Request

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

ResourceEffect
OperatorHard-deleted
virtual_number_operators (join rows)Hard-deleted — the operator is removed from any virtual number routing list
OperatorProject (project links)Hard-deleted
VirtualNumberUntouched — virtual numbers remain on the account
Inbound calls in flightUnaffected (the operator is no longer eligible for new routings)

Errors

StatusErrorDescription
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

See Also