> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knoxcall.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Environment

> Update one or more fields on an existing environment

## Update Environment

```text theme={"dark"}
PATCH /v1/environments/:id
```

Updates one or more fields on an existing environment.

### Path Parameters

| Parameter | Type | Description        |
| --------- | ---- | ------------------ |
| `id`      | uuid | The environment ID |

### Request Body

All fields are optional. Only provided fields will be updated.

| Field          | Type    | Description                                        |
| -------------- | ------- | -------------------------------------------------- |
| `name`         | string  | Machine-friendly name (must match `^[a-z0-9_-]+$`) |
| `display_name` | string  | Human-friendly display name                        |
| `description`  | string  | Description                                        |
| `color`        | string  | Hex color code                                     |
| `is_default`   | boolean | Set as default environment                         |

### Response

Returns the updated environment object.

### Errors

| Status | Type               | Description                                  |
| ------ | ------------------ | -------------------------------------------- |
| 400    | `validation_error` | Invalid name format                          |
| 404    | `not_found`        | Environment not found                        |
| 409    | `conflict`         | An environment with this name already exists |