Delete an app

​

Before you start

• Decide what happens to each database the app uses. The dialog offers Keep or Delete for each one.
• To stop an app for a while instead, pause it.

​

Steps

1

Open the delete dialog

Open the app and go to Settings. Under Danger zone, Delete this service, click Delete. You can also click … (More actions) at the top of the app page and choose Delete service.

2

Keep or delete each linked database

The dialog lists each database linked to the app, with its plan and price.

• Keep (the default): the database keeps running and billing, for example “Keeps running and billing $7.99/mo”. Only the app’s login to it is removed.
• Delete: the database is deleted with the app. Its backups are kept for 14 days, and on a monthly plan the unused part of the month goes back to your account balance.

A database that another app also uses is always kept, and the dialog names the other app.

3

Confirm

Under Why are you deleting this service?, pick a reason, then click Delete service.

​

What happens

• All instances stop and the app’s address is removed. Its deploy history and pull request previews are deleted too.
• The delete finishes in the background. Then the app’s name and address can be used again, and its custom domains are freed. Remove their DNS records if you no longer need them.
• The app’s own login to each linked database is removed. A database you kept keeps its data and keeps billing.
• Billing: usage up to the delete is billed, nothing after it. On a monthly plan, the unused part of the month goes back to your account balance.

​

Do it from your tools

curl -X DELETE "https://api.rafftechnologies.com/api/v1/apps/services/$APP_ID" \
  -H "X-API-Key: $RAFF_API_KEY"

# Asks to confirm; --force skips the question
raff apps delete $APP_ID

​

Next steps