Description
Updates a project variable value. Pass only the fields to change. Existing filters are preserved unless explicitly overwritten.
Omitting theValue keeps the stored value. This is how to rescope a secret whose value cannot be read back.
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. |