Skip to main content
DELETE /api/v1/projects/{project_id}/environments/{id} Requires environments.delete permission.
Deleting an environment cascades to all flags, environment API keys, region assignments, and queued events associated with it. This action cannot be undone.

Path parameters

project_id
string
required
UUID of the project.
id
string
required
UUID of the environment to delete.

Response

deleted
boolean
required
Always true when the deletion succeeds.

Errors

StatusWhen
400Invalid path parameter format
401Missing or invalid Bearer token
403Caller lacks environments.delete permission
404Project or environment not found

Example

curl -X DELETE http://localhost:8080/api/v1/projects/p1b2c3d4-e5f6-7890-abcd-ef1234567890/environments/e1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <token>"
{
  "deleted": true
}

Build docs developers (and LLMs) love