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

# deleteProject

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

## Request

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

Manage scope. Delete a project after typing its CURRENT name verbatim as confirm. Only possible once every environment inside it is deleted; its variable groups (and their sealed secrets) go with it. No application is uninstalled — a deletable project is already empty.

## Path parameters

- `id` string, required

## Request body

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

## Response `200`

Deleted

## Other responses

- `400`: Confirmation missing or mismatched
- `403`: Required scope missing
- `404`: Resource or current ownership unavailable
- `409`: The project still has environments
- `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)