---
title: "Retire a saved setup from new selection; retain immutable revisions and active job evidence"
method: DELETE
path: "/environments/{name}"
tags: ["environments"]
---

# Retire a saved setup from new selection; retain immutable revisions and active job evidence

`DELETE /environments/{name}`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/environments/{name}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Retire a saved setup from new selection; retain immutable revisions and active job evidence.

## Path parameters

- `name` string, required

## Response `200`

Successful response

- unknown

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)