material.set_input
Set a specific material input value (scalar, vector, or color) inside an active transaction, with explicit confirmation required for shared materials.
Instructions
Set one exact unlinked, undriven scalar/vector/color material input inside the active transaction. Shared materials require explicit confirmation.
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": {
"transaction_id": "<transaction_id>",
"object_name": "<object_name>",
"expected_object_identity": "<expected_object_identity>",
"material_slot_index": "<material_slot_index>",
"material_name": "<material_name>",
"expected_material_identity": "<expected_material_identity>",
"expected_material_users": "<expected_material_users>",
"node_name": "<node_name>",
"expected_node_identity": "<expected_node_identity>",
"socket_identifier": "<socket_identifier>",
"expected_socket_identity": "<expected_socket_identity>",
"value": "<value>",
"expected_scene_generation": "<expected_scene_generation>",
"idempotency_key": "<idempotency_key>"
},
"name": "material.set_input"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | ||
| node_name | Yes | ||
| object_name | Yes | ||
| allow_shared | No | ||
| material_name | Yes | ||
| transaction_id | Yes | ||
| idempotency_key | Yes | ||
| socket_identifier | Yes | ||
| material_slot_index | Yes | ||
| expected_node_identity | Yes | ||
| expected_material_users | Yes | ||
| expected_object_identity | Yes | ||
| expected_socket_identity | Yes | ||
| expected_scene_generation | Yes | ||
| expected_material_identity | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||