Objective
This article helps you permanently remove a TwiML App you no longer need, and explains the confirmation step so you do not delete one by accident.
Product
Programmable Voice
Environment
Twilio Console
User Account Permission/Role(s) Required
Your user needs permission to read TwiML Apps on the account to reach the app. Without it, the console shows an access-required message.
Procedure
- In the Twilio Console, select Builder tools in the left sidebar.
- Select TwiML host & config, then TwiML apps.
- Select the app you want to remove.
- Select Delete TwiML app in the page header.
- Read the Delete this TwiML app? dialog. It names the app you are about to delete and warns that you cannot undo the action.
- Select Delete this TwiML app to confirm.
- A confirmation appears reading TwiML app deleted successfully, and the console returns you to the TwiML Apps list, where the app is no longer shown.
Additional Information
Deleting a TwiML App cannot be undone. Before you delete one, check that no phone number still depends on it for call or message handling, because those numbers lose the configuration the app was supplying.
Select Cancel in the dialog to keep the app, you stay on the app's page and nothing is deleted.
A reserved application cannot be deleted. On one of those, the page shows a Reserved application notice and offers no Delete TwiML app action.
This content was generated by AI and reviewed, edited, and verified by a human.