Revolve sketch
revolveTurns a sketch profile around an axis to create a solid of revolution or cut a groove. Draw the profile and construction-line axis in one sketch, then set angle and operation.
Instructions
Revolve the closed regions of a sketch around an axis into a solid of revolution (a bottle, a pulley, a washer) or cut a groove with it (operation 'remove'). Draw the profile on one side of the axis and, in the same sketch, the axis as a construction line. The reply says what changed (parts, volume) and lists the created parts.
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>",
"sketch_feature_id": "<sketch_feature_id>"
},
"name": "revolve"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| axis | No | The axis to turn about: the ID of an edge or cylindrical face (from get_body_details) or 'sketch:<feature_id>'. Omit it to use the construction line drawn in the SAME sketch (add a `line` shape with construction=true next to the profile); it must be the only construction line there. | |
| name | No | Feature name (default 'Revolve 360 deg'). | |
| angle | No | Angle in degrees (default 360: a full revolution). | |
| 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. | |
| operation | No | 'new' creates a separate part; 'add' merges into existing parts; 'remove' cuts material away (a groove, a bore); 'intersect' keeps the overlap. | new |
| part_name | No | Name for the part an operation 'new' creates, e.g. 'Flanged bushing'. Give one unless the user chose a name. | |
| symmetric | No | Partial revolve: half the angle to each side of the sketch. | |
| element_id | Yes | Element (tab) ID: the string after /e/ in the Onshape URL. Get it from get_document. | |
| only_parts | No | Part IDs (list_parts) that 'add', 'remove' and 'intersect' should affect instead of every part touched. | |
| 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. | |
| sketch_feature_id | Yes | feature_id returned by create_sketch. | |
| opposite_direction | No | Turn the other way. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||