set_variable_value
Set ONE variant's value on a grouped variable, preserving every other variant.
Set ONE variant's value on a grouped variable, preserving every other variant.
Writes data · Idempotent · Calls external systems.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
acknowledge | boolean | No | Reset edit budget after user approval |
value | string | Yes | New value for this variant |
variable_id | number | Yes | Variable id (must be group-scoped) |
variant | string | Yes | Variant id (number) or name (string) |
Example arguments
Illustrative arguments an agent supplies when calling this tool:
{
"variable_id": 0,
"variant": "string",
"value": "string"
}
Description
variant accepts the variant id (number) or name (string); name resolution loads the parent group's variants. Errors when called on a global variable — globals have no variants; use update_variable default_value instead. Errors when the variant is not present on the variable.
This sets ONE variable in ONE variant. To bulk-copy ALL variables' values from one variant into another across the whole group, use copy_variant_values instead.
Related
What's next?
Last updated on