Delete an app and everything it owns. Volumes are kept unless `delete_volumes=true`.

DELETE

/api/v1/projects/{project}/environments/{environment}/apps/{app}

const url = 'https://example.com/api/v1/projects/example/environments/example/apps/example';
const options = {method: 'DELETE'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://example.com/api/v1/projects/example/environments/example/apps/example

Parameters

Path Parameters

project

required

string

Project name

environment

required

string

Environment short name

app

required

string

App name

Query Parameters

delete_volumes

boolean

Also delete the app’s persistent volumes. Irreversible.

Responses

204

Deleted

404

application/json

Problem Details body.

object

code

required

Stable machine-readable code, e.g. forbidden.

string

title

required

Short human readable title.

string

status

required

HTTP status.

integer format: int32

detail

Details, if safe to expose.

string | null

Example

{
  "code": "forbidden"
}