Organizations

Remove an organization phone number

DELETE
/api/organizations/{organizationId}/phone-numbers/{phoneNumberId}

Detaches any AI voice wiring first (fails with 502 if the provider refuses). If unresolved conversations still reference the number it is disabled (status: inactive, softDisabled: true) instead of removed; otherwise it is soft-deleted. Removing or disabling the org default clears the default and says so (clearedOrgDefault). Admin or SuperAdmin.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

organizationId*string

The organization that owns the phone numbers.

phoneNumberId*string

_id of the PhoneNumber resource.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/organizations/string/phone-numbers/string"
{  "success": true,  "softDisabled": true,  "clearedOrgDefault": true,  "message": "string"}