// Workspace Variables

Update a workspace variable value

Update a scoped value on a workspace variable.

PUT/api/workspace-variable/value

Description

Updates the value content and/or its filters. Pass only the fields to change.

Omitting theValue keeps the stored value. This is how to rescope a secret whose value cannot be read back.

Parameters

NameInTypeRequiredDescription
variableValueId body string yes ID of the value.
theValue body string no New value content. Omit to keep the stored value and change only the filters.
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.
tagFilter body array<object> no Replacement tag filter.

Errors

StatusMeaning
400 Invalid variableValueId or filter validation failure.
401 Missing or invalid Basic auth credentials, or the service account lacks the required role.