Update feature parameters
update_featureChange parameters of existing Onshape features to resize extrudes or fillets without rebuilding. Dependent features rebuild automatically, and multiple features can be updated in one request.
Instructions
Change parameters of existing features (for example make an extrude deeper or a
fillet larger) without rebuilding them. Dependent features rebuild automatically. To
change several features at once pass updates: two requests in total, however many.
An automatically named extrude ('Extrude 8 mm') gets its name refreshed when its depth
changes (single-feature form).
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": "update_feature"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional new feature name. | |
| updates | No | Change SEVERAL features in ONE Onshape request instead of feature_id + parameters. Names are not changed in this form. | |
| element_id | Yes | Element (tab) ID: the string after /e/ in the Onshape URL. Get it from get_document. | |
| feature_id | No | Feature ID (list_features) when changing one feature. | |
| parameters | No | Map of parameter ID to new value, e.g. {'depth': 25} for an extrude or {'radius': 2} for a fillet. Numbers are lengths in the configured unit (degrees for angle parameters). Strings may carry units ('1 in') or be expressions ('#width'). Booleans and enum names are set as-is. Use list_features with feature_id to see a feature's parameter IDs. | |
| 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 | |||