CustomDomain Docs
ReferenceAPI referenceApplications

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.

DELETE
/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}).

AuthorizationBearer <token>

Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/applications/string"
Empty
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}