# Delete an application

> Delete an application: reference page for this CustomDomain™ API operation in the applications group. Covers parameters, the request body, responses and errors.

Source: https://docs.customdomain.ai/docs/api-reference/applications/deleteApplication

## `DELETE https://api.customdomain.ai/v1/applications/{id}`

Deletes one of your applications together with what belongs only to it: its API keys stop working, and its webhook endpoints, share links and settings are removed. Needs an admin or owner key (it revokes keys). Another tenant's application is a 404.

Refused with `409` when deleting would break something that works, each with the reason in `details`: `default_application` (your workspace's default application, the oldest one: the signup key and your team's access belong to it, so it also keeps your last application), `application_key_in_use` (the key making the request belongs to this application) and `application_has_domains` (it still has domains, in any state; disconnect them first with `DELETE /connections/{id}`).

### Authentication

`apiKey`, `managementKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

### Responses

| Status | Description |
| --- | --- |
| `204` | Deleted |
| `401` | Error envelope: {code, title, details}. |
| `403` | Error envelope: {code, title, details}. |
| `404` | Error envelope: {code, title, details}. |
| `409` | Error envelope: {code, title, details}. |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.
