Delete app

Delete an existing app, identified by its id.

Deletion is asynchronous and eventually consistent. The app and all of its associated resources (environments, deployments, custom domains) are torn down by a background workflow. A successful response indicates the deletion was enqueued, not that every resource has already been removed.

Apps with delete protection enabled cannot be deleted until protection is disabled.

Required Permissions

Your root key must have one of the following permissions:

• app.*.delete_app (to delete any app)
• app.<app_id>.delete_app (to delete a specific app)

{
  "project": "proj_1234abcd",
  "app": "proj_1234abcd"
}

{
  "meta": {
    "requestId": "req_123"
  }
}