Circular pattern
circular_patternRepeat parts, features, or faces around an axis to create spokes, bolt holes, or wheel patterns. Pattern a feature so copies merge or cut as the original does.
Instructions
Repeat parts, features or faces around an axis (a wheel's spokes, bolt holes on a circle). Pattern the FEATURE that makes one spoke or hole (feature_ids) so the copies merge or cut as it does; pattern parts (part_ids) to get separate copies. Put the count in a variable ('#spokes') when it should be configurable. The default name shows the count ('Circular pattern x6'). The reply says what changed (parts, volume).
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>",
"count": "<count>",
"axis": "<axis>"
},
"name": "circular_pattern"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| axis | Yes | The axis to turn about: the ID of a cylindrical or conical face or of a circular or straight edge (from get_body_details), or 'sketch:<feature_id>' to use the construction line drawn in that sketch (create_sketch with a `line` shape and construction=true). | |
| name | No | ||
| angle | No | Total angle in degrees (default 360: a full circle, instances 360/count apart). With equal_spacing=false it is the angle BETWEEN instances. | |
| count | Yes | Number of instances INCLUDING the original (2 or more), or an Onshape expression such as '#spokes' so a variable or configuration can drive it. | |
| 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. | |
| face_ids | No | Repeat these faces (IDs from get_body_details). Give exactly one of part_ids, feature_ids and face_ids. | |
| part_ids | No | Repeat these whole parts (IDs from list_parts). Give exactly one of part_ids, feature_ids and face_ids. | |
| operation | No | Only for part_ids: 'new' makes each copy a separate part (default); 'add' merges the copies into existing parts; 'remove' cuts with them; 'intersect' keeps the overlap. | new |
| element_id | Yes | Element (tab) ID: the string after /e/ in the Onshape URL. Get it from get_document. | |
| merge_with | No | Part IDs the copies merge with when operation is 'add', 'remove' or 'intersect' (default: every part they touch). | |
| document_id | Yes | Onshape document ID: the 24-character hex string after /documents/ in the document URL. Get it from list_documents. | |
| feature_ids | No | Repeat these features (feature_id of an extrude or other feature, e.g. one spoke of a wheel); each copy merges the way the feature does. Give exactly one of part_ids, feature_ids and face_ids. | |
| workspace_id | No | Workspace ID (the string after /w/ in the URL). Optional - defaults to the document's main workspace. | |
| equal_spacing | No | Spread the instances equally over `angle`. | |
| opposite_direction | No | Turn the other way. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||