set_instance_properties
Update a Figma instance's component properties (variants, booleans, text, instance swaps) using exact property names from get_component_api. Keeps unspecified properties unchanged and returns success status.
Instructions
Set an instance's component properties (variant / boolean / text / instance-swap). Keys are the property names from get_component_api, used verbatim: VARIANT by bare name (e.g. "Size": "Large"), BOOLEAN/TEXT/INSTANCE_SWAP suffixed with #id (e.g. "Label#2:0": "Sign in", "Disabled#1:2": true). An INSTANCE_SWAP value is the target component node id. Unspecified properties keep their value; SLOT properties are not settable. Returns { ok, nodeId }.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"instanceId": "<instanceId>",
"properties": "<properties>"
},
"name": "set_instance_properties"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| instanceId | Yes | Instance node id to update | |
| properties | Yes | Map of property name (verbatim from get_component_api) → value |