---
title: "Delete environment"
method: DELETE
path: "/api/v1/environments/{id}"
tags: ["Environments"]
---

# Delete environment

`DELETE /api/v1/environments/{id}`

Deletes a non-default environment definition when `If-Match` matches the current environment revision.

## Path parameters

- `id` string, required

## Headers

- `If-Match` string, required

## Response `204`

Environment deleted

## Other responses

- `400` — Invalid environment id or revision header
- `404` — Environment not found
- `409` — Environment revision mismatch or protected environment conflict
- `428` — Missing required `If-Match` header
- `500` — Environment store operation failed

## Changes

- **2026-05-29** `254ffe92951a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/environments/:id/delete.md)

---

[API](https://skmtc.dev/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.dev/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/7bdeefd151cd/schema)