Delete Application

DELETE /v1/applications/{uuid}

Permanently delete an application, its git connection, every deploy, its environment variables and cron jobs, and (for a backend app) its running backend. Object storage for the app's deploys is cleaned up best-effort.

The delete is blocked while any endpoint still serves the app — an app can have several, and deleting the app never deletes them. List them with GET /v1/endpoints?application_uuid={uuid}, delete each one, then retry.

Databases: the app's database connections are removed with it, and every database it used stays, with its users and data — one created with POST /v1/databases and also the one the app got from POST /v1/applications/{uuid}/database. A kept database still counts against your plan's database limit until you delete it. The exception is a WordPress site's own database, which is deleted with the site.

Backups: the app's own backups are deleted with it — its content and full backups, and any older database backup that isn't tied to a database. A database's backups belong to the database: they stay with every database that stays (see database backups). A WordPress site's own database is deleted with the site, and its backups with it.

Response

204 No Content
Deleted. The response body is empty.

Errors

404 Not Found
Unknown application in the active account.
409 Conflict
One or more endpoints still serve this application (application is in use by N endpoint(s); detach them first). Delete them first.
Request
curl -X DELETE "https://api.ngris.com/v1/applications/019be838-d261-7d9b-9499-71995a3a91c6" \ -H "X-API-KEY: <your_api_key>"
Response — 409 Conflict
{ "error": "application is in use by 2 endpoint(s); detach them first" }
Was this helpful?
On this page
Delete Application
Was this helpful?