---
title: "deleteEnvironment"
method: POST
path: "/platform/environments/{id}/delete"
tags: ["Platform"]
---

# deleteEnvironment

`POST /platform/environments/{id}/delete`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/environments/{id}/delete`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Manage scope. Delete an environment after typing its CURRENT name verbatim as confirm. Only possible once every service is detached; its variable group goes with it. No application is stopped or uninstalled.

## Path parameters

- `id` string, required

## Request body

- object
  - `confirm` string, required: The current environment name, verbatim.

## Response `200`

Deleted

## Other responses

- `400`: Confirmation missing or mismatched
- `403`: Required scope missing
- `404`: Resource or current ownership unavailable
- `409`: The environment still has services
- `503`: Storage unavailable; read before retrying

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)