vw_create_layer
Add a design or sheet layer to the open Vectorworks document, optionally setting its scale and making it active. Use it to organize drawings or prepare presentation sheets; nothing is drawn on the layer.
Instructions
Create a design layer or a sheet layer in the open document. Adds the layer only; nothing is drawn on it. For a sheet with a viewport and title block use vw_create_sheet instead. The user's active layer stays active unless activate=True. One revertible step: vw_revert_last deletes the layer. Returns {name, kind, active}.
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": {
"name": "<name>"
},
"name": "vw_create_layer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | 'design' for a model/drawing layer, 'sheet' for a presentation sheet layer. | design |
| name | Yes | Name of the new layer. Fails if a layer of that name exists. | |
| scale | No | Design layers only: scale denominator, for example 48 for 1/4" = 1', 100 for 1:100. Omitted: the document's default. | |
| activate | No | True makes the new layer the active layer. Default False keeps the user's active layer. | |
| document | No | Name of the document this call may change, as listed by vw_list_documents. If given and another document is in front, nothing changes and the call fails; use vw_switch_document first. Always pass it for writes. |