Description
Adds a new value for a project variable. Use environmentsFilter, machineFilter, cloudTargetFilter, and tagFilter to scope the value to a subset of deployment targets. Multiple values can exist for the same variable with different scopes.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
variableId |
body | string | yes | ID of the project variable. |
theValue |
body | string | no | Value content. Optional - defaults to empty. |
environmentsFilter |
body | array<string> | no | Restrict to these environment IDs. |
machineFilter |
body | array<string> | no | Restrict to these machine IDs. |
cloudTargetFilter |
body | array<string> | no | Restrict to these cloud target IDs. |
stepFilter |
body | array<string> | no | Restrict this value to these project step IDs. IDs must belong to the variable's project. |
tagFilter |
body | array<object> | no | List of { tagIds: [...] } sets. A target matches if it has every tag in at least one set. |
Errors
| Status | Meaning |
|---|---|
400 |
Invalid variableId, or one of the filter IDs is not visible to the project's workspace. |
401 |
Missing or invalid Basic auth credentials, or the service account lacks the required role. |