How do I delete a phone number through the dashboard?
The available sources primarily document the API method for deleting phone numbers rather than the dashboard process(1). However, based on community discussions, you can delete phone numbers manually through the dashboard once they’re not bound to any agent(2).
If you encounter an internal server error when trying to delete a phone number through the dashboard, you should first unbind the phone number from any agent using the update API, then retry the delete(2).
For phone numbers that are “in review” for branding, you may be unable to delete them through the dashboard until the review process completes or is cancelled(3). In such cases, you would need to contact Retell support with your organization ID and the phone number details to have the review cancelled or the number deleted(3).
Hello @sales
You can delete the phone number
Go to the phone numbers tab → choose the number you want to edit → click on the 3 dots like the image → Delete
Or if you just want to edit it, you can click Edit phone number settings
To delete a phone number in Retell AI, you can use the dashboard interface by navigating to the phone numbers tab, selecting the number you want to manage, clicking the three dots menu, and choosing “Delete”(1).
Alternatively, you can delete a phone number programmatically using the API(2):
import Retell from 'retell-sdk';
const client = new Retell({
apiKey: 'YOUR_RETELL_API_KEY',
});
await client.phoneNumber.delete('+14157774444');
The API endpoint is DELETE /delete-phone-number/{phone_number}, where the phone number must be in E.164 format(2).
If you encounter an error stating the phone number already exists but it’s not visible in your account, the number may be linked to another Retell account(1). In such cases, you’ll need to provide proof of ownership (such as a screenshot from your telephony provider showing the Phone Number SID) along with your Organization ID to have the team investigate and potentially transfer the number to your workspace(3).