# Update a project variable value

Source: https://www.jawsdeploy.net/rest-api/project-variable-value-update | Section: Project Variables

Update a scoped value on a project variable.

`PUT /api/project/variable/value`

Updates a project variable value. Pass only the fields to change. Existing filters are preserved unless explicitly overwritten.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `variableValueId` | body | string | yes | ID of the variable value. |
| `theValue` | body | string | no | New value content. |
| `environmentsFilter` | body | array<string> | no | Replacement environments filter. |
| `machineFilter` | body | array<string> | no | Replacement machine filter. |
| `cloudTargetFilter` | body | array<string> | no | Replacement cloud target filter. |
| `stepFilter` | body | array<string> | no | Replacement project step IDs. Omit to keep the existing step scope; pass an empty array to clear it. |
| `tagFilter` | body | array<object> | no | Replacement tag filter. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid `variableValueId` or filter validation failure. |
| 401 | Missing or invalid Basic auth credentials, or the service account lacks the required role. |

Example request:

```
PUT /api/project/variable/value

{ "variableValueId": "vv_1", "theValue": "false" }
```

Example response:

```
{}
```