Create a document version
onshape_create_versionSnapshot a workspace as an immutable version before restructuring a design, preserving a rollback point and giving drawings a stable version to reference.
Instructions
Snapshot the workspace as an immutable version. Do this before restructuring an existing design: it is the only way back to the previous state, and drawings must reference a version.
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": {
"doc": "<doc>",
"ws": "<ws>",
"name": "<name>"
},
"name": "onshape_create_version"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ws | Yes | Workspace id — the <ws> segment of the document URL. | |
| doc | Yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. | |
| name | Yes | Version name, e.g. what is about to change. | |
| description | No | Why this snapshot was taken. |