Skip to content

Delete an app

DELETE
/v1/apps/{appName}
curl --request DELETE \
--url https://api.aetherpush.com/v1/apps/example \
--header 'Authorization: Bearer <token>'

Permanently deletes the app, all its deployments, and all release history. Cannot be undone. Requires the app.delete permission (Owner).

appName
required
string

The app name. Note that renaming an app changes this path.

App deleted.

Insufficient permissions (app.delete required).

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
"error": "The requested resource was not found.",
"requestId": "req_abc123"
}

App not found.

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
"error": "The requested resource was not found.",
"requestId": "req_abc123"
}