Shell
shellHollow out a CAD part with uniform walls, either opening selected faces or creating a closed internal void, instead of cutting an inner pocket manually.
Instructions
Hollow out a part with walls of the given thickness. Give remove_face_ids to leave
those faces open (a box without a lid, a cup, an enclosure) or hollow_part_ids to hollow a
part completely and leave a closed void inside - exactly one of the two. The walls grow
inward by default; opposite_direction grows them outward from the original surface.
Example: a 40 x 30 x 20 mm box (24 000 mm3) shelled to 2 mm walls with the top face removed
keeps 7 152 mm3. Use it instead of cutting an inner pocket by hand with extrude
(operation 'remove'); use boolean to combine or subtract whole parts. The face IDs come
from get_body_details. It appends one shell feature and returns its health plus
effect (parts and total volume before and after) and a warning when nothing changed:
Onshape can accept a feature that does nothing, so read it: a wall too thick for the part is
accepted as OK and changes nothing (a 50 mm wall on a 40 x 30 x 20 mm box answered OK with
the volume unchanged), and only that warning tells you. Remove it with delete_feature.
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>",
"thickness": "<thickness>"
},
"name": "shell"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Feature name (default 'Shell 2 mm'). | |
| verify | No | Measure the Part Studio before and after (two extra requests) and report what changed: part count and total volume, plus a warning when nothing changed (Onshape can accept a feature that does nothing). Set false to save requests. | |
| thickness | Yes | Length: a number in the configured unit (see get_settings; mm by default), a string with a unit such as '2.5 in', or an Onshape expression such as '#width'. | |
| 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. | |
| hollow_part_ids | No | Parts (list_parts) to hollow out completely, leaving a closed void inside. Give exactly one of remove_face_ids and hollow_part_ids. | |
| remove_face_ids | No | Faces to open up (from get_body_details): the part becomes a hollow shell open at these faces, like a box without a lid. Give exactly one of remove_face_ids and hollow_part_ids. | |
| opposite_direction | No | Grow the wall outward instead of inward. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||