Skip to main content
DELETE
Delete phone number

Deletion Modes

Normal deletion (force=false):
  • Fails if phone number is linked to any agents
  • Returns 409 Conflict if agents are using this number
Force deletion (force=true):
  • Automatically unlinks phone number from all agents
  • Updates affected agents to remove the phone number reference
  • Completes deletion even if agents were using the number

Best Practice

Check affected agents before deletion using the /affected-agents endpoint to understand the impact.

Path Parameters

id
string<uuid>
required

Phone number identifier

Query Parameters

force
boolean
default:false

Force deletion by unlinking from agents

Response

Phone number deleted successfully