---
title: "Update Environment Variable"
method: PATCH
path: "/v1/environments/{environmentId}/variables/{id}"
tags: ["Environments"]
---

# Update Environment Variable

`PATCH /v1/environments/{environmentId}/variables/{id}`

Updates a variable. Only provided fields are changed. Source-backed personal environments can override inherited variable keys only when the inherited variable has `personal_override_allowed: true`.

## Path parameters

- `environmentId` string, required
- `id` string, uuid, required

## Request body

- UpdateEnvironmentVariableRequest — Request body for updating an environment variable. Only provided fields are changed.
  - `key` string
  - `value` string
  - `personal_override_allowed` boolean — Team/Global variables only. Allows source-backed personal environments to override this inherited key.

## Response `200`

Variable updated

- EnvironmentVariableResponse
  - `environment_variable` EnvironmentVariable, required — An environment variable. Values are encrypted at rest and decrypted on read.
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `environment_id` string, uuid, required
    - `key` string, required — Variable name (e.g. `DATABASE_URL`)
    - `value` string, required — Variable value (returned in plaintext)
    - `personal_override_allowed` boolean, required — Whether source-backed personal environments may override this inherited key
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Bad request - Missing or invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Admin access required to change personal override policy
- `404` — Resource not found
- `409` — Conflict - Resource already exists or operation conflicts with current state
- `500` — Internal server error

---

[API](https://skmtc.net/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.net/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/versions/aa3b4c932f7a/schema)