Skip to main content
DELETE
Delete Phone Number
Delete a phone number. For SIP providers, this also cleans up associated LiveKit trunks.
Cannot delete phone numbers that are assigned to agents. Unassign first.

Headers

string
required
Your API key for authentication.
string
required
The organization ID.

Path Parameters

string
required
The unique identifier of the phone number to delete.

Permissions

  • phone_numbers:delete (admin, agent_manager)

Response

boolean
Indicates if the deletion was successful.
string
Human-readable success message.
object
The deleted phone number object.

Errors

object
Cannot delete assigned phone number. Unassign it first.
object
Phone number not found.
object
Phone number belongs to different organization.