// Project Variables

Add a project variable value

Add a scoped value for a project variable.

POST/api/project/variable/value

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

NameInTypeRequiredDescription
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.
tagFilter body array<object> no List of { tagIds: [...] } sets. A target matches if it has every tag in at least one set.

Errors

StatusMeaning
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.