← Beezifi CAD

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

RequestWhat it does
GET /api/drawingsYour drawings and the templates.
POST /api/drawingsCreate: {title, units}, {sample} or {dxf} (DXF text).
POST /api/drawings/importMultipart upload of a .dwg (R13–2018 and later), .dxf or .json file. DWG is converted on the server.
GET /api/drawings/:idThe full drawing JSON.
GET /api/drawings/:id/summaryUnits, extents, layers, blocks and object counts (?entities=N lists the first N objects).
GET /api/drawings/:id/entitiesFind objects: type, layer, text, window=x0,y0,x1,y1, crossing=1, full=1, limit, offset.
GET /api/drawings/:id/entities/:handleOne object.
POST /api/drawings/:id/commandsRun engine commands in order. People with the drawing open see the changes live.
POST /api/drawings/:id/command-lineRun a command-line script; returns the command history text.
GET /api/drawings/:id/comparewith=<drawing id> or version=<version id>: the objects added, changed and removed since then.
GET /api/drawings/:id/exportformat=dxf|svg|png|json; images take width, height, window, dark=1.
PATCH / DELETE /api/drawings/:idRename, or delete (recoverable for 30 days).
…/shares, …/versions, …/activitySharing, version history (save, preview, restore) and the activity log.
GET /api/commandsEvery engine command with its parameters.
GET /api/optionsEntity 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.