[Skip to content](https://coolify.io/docs/api-reference/api/operations/delete-environment#VPContent)

Return to top

Delete Environment[​](https://coolify.io/docs/api-reference/api/operations/delete-environment#delete-environment)

==================================================================================================================

DELETE

/projects/{uuid}/environments/{environment\_name\_or\_uuid}

Delete environment by name or UUID. Environment must be empty.

Authorizations[​](https://coolify.io/docs/api-reference/api/operations/delete-environment#authorizations)

----------------------------------------------------------------------------------------------------------

bearerAuth

Go to `Keys & Tokens` / `API tokens` and create a new token. Use the token as the bearer token.

Type

HTTP (bearer)

Parameters[​](https://coolify.io/docs/api-reference/api/operations/delete-environment#parameters)

--------------------------------------------------------------------------------------------------

### Path Parameters

uuid\*

Project UUID

Type

string

Required

environment\_name\_or\_uuid\*

Environment name or UUID

Type

string

Required

Responses[​](https://coolify.io/docs/api-reference/api/operations/delete-environment#responses)

------------------------------------------------------------------------------------------------

200400401404422

Environment deleted.

Content-Type

application/json

SchemaJSON

JSON

{

"message": "Environment deleted."

}

DELETE

/projects/{uuid}/environments/{environment\_name\_or\_uuid}

Playground[​](https://coolify.io/docs/api-reference/api/operations/delete-environment#playground)

--------------------------------------------------------------------------------------------------

Authorization

bearerAuth

Variables

Key

Value

uuid\*

environment\_name\_or\_uuid\*

Try it out

Samples[​](https://coolify.io/docs/api-reference/api/operations/delete-environment#samples)

--------------------------------------------------------------------------------------------

Powered by [VitePress OpenAPI](https://github.com/enzonotario/vitepress-openapi)