Add or change a configuration input
set_configuration_inputAdd or replace a named configuration input in a Part Studio to create dropdown lists or numeric parameters that drive model dimensions.
Instructions
Add a configuration input to a Part Studio, or replace the input of the same name. Only
when the user asks for configurations. To make dimensions depend on a list input, use
set_variable with by_option.
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": {
"document_id": "<document_id>",
"element_id": "<element_id>",
"name": "<name>"
},
"name": "set_configuration_input"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Type of input. | list |
| name | Yes | Input name, e.g. 'Size' or 'Length'. Number inputs are usable in expressions as '#Length'. | |
| default | No | List: the default option (first one if omitted). Number inputs: the default value (length in the configured unit, degrees for an angle). | |
| maximum | No | Number inputs: highest value. | |
| minimum | No | Number inputs: lowest value. | |
| options | No | For a list: the choices, e.g. ['M10', 'M18'] (at least two). | |
| element_id | Yes | Element (tab) ID: the string after /e/ in the Onshape URL. Get it from get_document. | |
| document_id | Yes | Onshape document ID: the 24-character hex string after /documents/ in the document URL. Get it from list_documents. | |
| workspace_id | No | Workspace ID (the string after /w/ in the URL). Optional - defaults to the document's main workspace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||