DELETE
/phone_numbers/{phone_number_id}Delete a phone number
Deletes a phone number by its identifier. Use this operation to remove a phone number you no longer need; the response confirms whether it was deleted.
phone_number_idstringrequired
The ID of the phone number to delete.
200Returns a deletion result object with the object type and a `deleted` flag; the object may also include its ID, slug, and external ID.
objectstringrequired
idstringoptional
slugstringoptional
deletedbooleanrequired
external_idstringoptional
400Returned when the request is unsuccessful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Returned when authorization is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the phone number is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
Error handling
A 400 is returned when the request is unsuccessful; a 401 when authentication is invalid; a 403 when authorization is invalid; and a 404 when the phone number is not found. The phone_number_id path parameter must identify the phone number to delete.