> ## 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 Secret Value

> Replaces the encrypted value of an existing string secret

## Update Secret Value

```http theme={"dark"}
PUT /v1/secrets/:id/value
```

Replaces the encrypted value of an existing string secret. You can target a specific environment to set an environment-specific override.

### Path Parameters

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

### Query Parameters

| Parameter     | Type   | Default          | Description                   |
| ------------- | ------ | ---------------- | ----------------------------- |
| `environment` | string | Base environment | Target a specific environment |

### Request Body

| Field   | Type   | Required | Description          |
| ------- | ------ | -------- | -------------------- |
| `value` | string | Yes      | The new secret value |

### Response

```json theme={"dark"}
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "STRIPE_API_KEY",
    "environment": "production"
  },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
```

### Errors

| Status | Type               | Description           |
| ------ | ------------------ | --------------------- |
| 400    | `validation_error` | Missing `value` field |
| 404    | `not_found`        | Secret not found      |