Beezifi CAD API
Every change in Beezifi CAD is an engine command, so the REST API, the MCP server and the editor all do the same things. Requests need Authorization: Bearer <token>: a session token from POST /api/auth/login, or a personal access token (bzc_…) created in the app under the account menu › AI connections.
Quick start
# a drawing
POST /api/drawings {"title":"Plate","units":"mm"}
# type at the command line (one command per line; points as x,y, @dx,dy or @dist<angle)
POST /api/drawings/:id/command-line {"script":"RECTANG 0,0 120,80\nCIRCLE 60,40 15\nDIMLINEAR 0,0 120,0 60,-12"}
# or run JSON commands
POST /api/drawings/:id/commands {"commands":[{"id":"layer.add","params":{"name":"Holes","color":1}},
{"id":"circle.add","params":{"c":[20,20],"r":4,"layer":"Holes"}}]}
# read it back
GET /api/drawings/:id/summary
GET /api/drawings/:id/entities?type=circle&layer=Holes
GET /api/drawings/:id/export?format=dxf|svg|png|json
Endpoints
| Request | What it does |
|---|---|
| GET /api/drawings | Your drawings and the templates. |
| POST /api/drawings | Create: {title, units}, {sample} or {dxf} (DXF text). |
| POST /api/drawings/import | Multipart upload of a .dwg (R13–2018 and later), .dxf or .json file. DWG is converted on the server. |
| GET /api/drawings/:id | The full drawing JSON. |
| GET /api/drawings/:id/summary | Units, extents, layers, blocks and object counts (?entities=N lists the first N objects). |
| GET /api/drawings/:id/entities | Find objects: type, layer, text, window=x0,y0,x1,y1, crossing=1, full=1, limit, offset. |
| GET /api/drawings/:id/entities/:handle | One object. |
| POST /api/drawings/:id/commands | Run engine commands in order. People with the drawing open see the changes live. |
| POST /api/drawings/:id/command-line | Run a command-line script; returns the command history text. |
| GET /api/drawings/:id/compare | with=<drawing id> or version=<version id>: the objects added, changed and removed since then. |
| GET /api/drawings/:id/export | format=dxf|svg|png|json; images take width, height, window, dark=1. |
| PATCH / DELETE /api/drawings/:id | Rename, or delete (recoverable for 30 days). |
| …/shares, …/versions, …/activity | Sharing, version history (save, preview, restore) and the activity log. |
| GET /api/commands | Every engine command with its parameters. |
| GET /api/options | Entity types, units, linetypes, lineweights, hatch patterns, snap modes and command-line commands. |
Commands
Loaded live from the server:
| Loading… (sign in to the app first) |
AI assistants (MCP)
Beezifi CAD hosts an MCP server at POST /mcp. Create a token in the app (account menu › AI connections) and add it to your client:
claude mcp add --transport http beezifi-cad https://your-host/mcp --header "Authorization: Bearer bzc_…"
Tools: list_drawings, get_drawing, query_entities, create_drawing, command_line, run_commands, list_commands, render (PNG), export_dxf, save_version.