update_variable
Update a variable's name, description, and/or default_value.
Update a variable's name, description, and/or default_value.
Writes data · Idempotent · Calls external systems.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
acknowledge | boolean | No | Reset edit budget after user approval |
default_value | string | No | New default value (string for single/secret, comma-separated for choice) |
description | string | No | New description (optional, recommended) — overwrites the current value. A short sentence describing the variable's purpose helps future agents disambiguate it. |
name | string | No | New name |
variable_id | number | Yes | Variable id |
Example arguments
Illustrative arguments an agent supplies when calling this tool:
{
"variable_id": 0
}Description
Properties only — this tool does NOT touch per-variant values. To change one variant's value use set_variable_value; to copy values across variants use copy_variant_values. Variable type is immutable on the platform; this tool preserves it.
A description is optional but RECOMMENDED on update too — if the original variable was created without one, this is the place to add semantic context that future agents will rely on.Related
What's next?
Last updated on