app
Fusion - the Fusion 360 Bridge
Public Made by Adomby adom
Drive Autodesk Fusion 360 from the cloud via Adom Bridge: component libraries, IPC package generation, board layout, exports (STEP/Gerbers/BOM/CPL), fast APS cloud search, and parametric modeling.
master
Drew Owens
Port occurrence translation and contract authoring to Rust; publish verified R21 source
a06dfd7
27d ago
{
"contract": "fusion-bridge verb catalog",
"frozen": "2026-10-06",
"note": "The Python bridge and the Rust bridge must both serve this catalog byte-for-byte in meaning: same names, same args, same result shapes, same timeouts. Regenerate ONLY from describe.py and diff in CI.",
"source": "describe.py",
"verbs": [
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_account",
"output": {
"account": "{email, name, userId, hub}",
"holdsSeat": "bool",
"license": "{authorized, trial, expiresAt, ...}",
"running": "bool",
"seatDialogOpen": "bool",
"signedIn": "bool",
"success": "bool"
},
"statusVerb": null,
"summary": "WHO Fusion is signed in as on this machine, and whether this machine currently holds the Autodesk SEAT. One subscription runs ONE active Fusion at a time, so the seat moves between machines; this is the read. Returns the signed-in account (email, name, hub), Autodesk's own licence blob (authorized, trial, expiry, reauthorize time, from Application.LicenseInformation) and holdsSeat. Read-only: never starts Fusion, never signs anybody in or out.",
"timeoutSeconds": 60
},
{
"example": {
"limit": 20
},
"input": {
"limit": "optional int (default 50)"
},
"longRunning": true,
"name": "fusion_action_ledger",
"output": {
"actions": "[{at, action, detail}]"
},
"statusVerb": null,
"summary": "Read the append-only record of what the bridge did in the BACKGROUND on this machine - dialogs it answered, Untitled scratch docs it swept, Fusion auto-starts, add-in restarts. Survives bridge respawns (~/.adom/fusion-bridge/actions.jsonl). This is the audit trail for why something changed on the user screen.",
"timeoutSeconds": 15
},
{
"example": {
"name": "TJA1050"
},
"input": {
"name": "required str (document name as reported by fusion_get_app_state)"
},
"longRunning": false,
"name": "fusion_activate_document",
"output": {
"activeDocument": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Make a named open document the ACTIVE one before driving it. EDIT and most modelling verbs act on whatever is active, so in a batch with several documents open this is how you stop a verb landing in the wrong file (page issue #47). Prefer passing expectDocument on the verb itself, which fails closed instead of merely re-targeting. An electronics design's schematic, board and 3D view are separate tabs with ONE name (type unknown): the reply says so in sameNameDocuments, and fusion_show_schematic / fusion_show_2d_board / fusion_show_3d_board {documentName} reach a specific view.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_addin_status",
"output": {
"addinReady": "bool",
"busy": "bool",
"port": "int",
"version": "str"
},
"statusVerb": null,
"summary": "Is the AdomBridge add-in loaded and answering inside Fusion? Reports addinReady, port and version, plus busy when a long command holds the main thread. If Fusion is running but this says not ready, the add-in was installed while Fusion was open - Fusion loads add-ins only at launch - so call fusion_restart_for_addin (ask the user first when one is present).",
"timeoutSeconds": 15
},
{
"example": {},
"input": {
"sinceSec": "optional float (default 300)"
},
"longRunning": false,
"name": "fusion_alerts",
"output": {
"alerts": "[{at,text}]"
},
"statusVerb": null,
"summary": "Fusion's OWN alert toasts, read from its log. Fusion draws error/warning toasts in CEF: they are invisible to Win32 enumeration AND to UIA, so a verb can look successful while Fusion is visibly complaining. This reads them, newest last.",
"timeoutSeconds": 30
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_apply_fusion_update",
"output": {
"applied": "bool",
"button": "str|null",
"why": "str"
},
"statusVerb": null,
"summary": "Readiness EXECUTOR (Rust port, Phase 3): click Fusion's update offer IN THE BACKGROUND when auto-update is on (sticky pref; fusion_set_auto_update). Never the exit-class buttons while a host op is active. Answers {applied, button, why}.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"boardId": "required",
"expectDocument": "required exact board name",
"expectedRevision": "required",
"pours": "required [{net, layer, points:[[x,y]...], isolate (mm, default 0.25), rank (default 1), width (mm, default 0.25), thermals (default true), orphans (default false)}]"
},
"longRunning": false,
"name": "fusion_apply_pours",
"output": {
"added": "[net]",
"filledAreaByLayerMm2": "{layer:mm2}",
"kept": "[net]",
"pours": "[{net,layer,outline,filledMm2,islands,filled}]",
"revision": "str",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Draw copper pours from a plan: POLYGON per pour (net, layer 1 or 16, outline points, isolate, rank 1..6, width, thermals, orphans), skipping any already on the board with the same net, layer and outline, then RATSNEST fills them. The reply carries Fusion's own fill per pour (filledMm2, islands) and per layer. Removing a pour is not done here.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"folderId": "optional str",
"hubId": "optional str",
"projectId": "optional str"
},
"longRunning": false,
"name": "fusion_aps_browse",
"output": {
"items": "[{name,type,id}]"
},
"statusVerb": null,
"summary": "Browse hubs/projects/folders without launching Fusion.",
"timeoutSeconds": 60
},
{
"example": {
"name": "Adom AI Workspace",
"parentFolderId": "urn:...",
"projectId": "a.YnVz..."
},
"input": {
"name": "required str",
"parentFolderId": "required str",
"projectId": "required str"
},
"longRunning": false,
"name": "fusion_aps_create_folder",
"output": {
"folderId": "str"
},
"statusVerb": null,
"summary": "Create a subfolder in a project (free; needs data:create scope). Use this to make an 'Adom AI Workspace' folder + per-task subfolders so the bridge never dumps loose files in the shared project root. See fusion-cloud-hygiene.",
"timeoutSeconds": 50
},
{
"example": {
"query": "BME690 Molecule"
},
"input": {
"fileName": "optional str",
"query": "str OR projectId+urn",
"saveDir": "optional str"
},
"longRunning": false,
"name": "fusion_aps_download",
"output": {
"bytes": "int",
"path": "str"
},
"statusVerb": null,
"summary": "Download a cloud file to the local machine (no Fusion needed).",
"timeoutSeconds": 90
},
{
"example": {
"query": "BME690 Molecule"
},
"input": {
"query": "str OR projectId+urn"
},
"longRunning": false,
"name": "fusion_aps_file_info",
"output": {
"tip": "{...}",
"versionCount": "int",
"versions": "[...]"
},
"statusVerb": null,
"summary": "Version history + who/when/size for a file (tip + recent versions).",
"timeoutSeconds": 40
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_aps_forget_browser",
"output": {
"cleared": "bool",
"success": "bool"
},
"statusVerb": null,
"summary": "Forget the remembered Autodesk sign-in browser (re-detect next time).",
"timeoutSeconds": 10
},
{
"example": {
"path": "/project/v1/hubs"
},
"input": {
"path": "required str"
},
"longRunning": false,
"name": "fusion_aps_get",
"output": {
"body": "obj",
"status": "int"
},
"statusVerb": null,
"summary": "Raw authenticated GET against a free APS path (dev/verify helper).",
"timeoutSeconds": 40
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_aps_get_browser",
"output": {
"browser": "{name,exe,profileDir}|null",
"success": "bool"
},
"statusVerb": null,
"summary": "Show the remembered Autodesk sign-in browser (None until set).",
"timeoutSeconds": 10
},
{
"example": {
"query": "BME690 Molecule"
},
"input": {
"query": "required str",
"wait": "optional bool"
},
"longRunning": true,
"name": "fusion_aps_open",
"output": {
"match": "{name}",
"opening": "bool",
"statusVerb": "str"
},
"statusVerb": "fusion_get_app_state",
"summary": "Find a cloud design by name and open it in Fusion (any folder depth). Fire-and-poll.",
"timeoutSeconds": 60
},
{
"example": {
"limit": 25
},
"input": {
"limit": "optional int (default 25)"
},
"longRunning": false,
"name": "fusion_aps_recent",
"output": {
"count": "int",
"results": "[...]"
},
"statusVerb": null,
"summary": "Most-recently-modified designs across the team hub, newest first.",
"timeoutSeconds": 120
},
{
"example": {
"limit": 10,
"query": "Molecule"
},
"input": {
"hubId": "optional str",
"limit": "optional int (default 50)",
"projectId": "optional str",
"query": "required str"
},
"longRunning": false,
"name": "fusion_aps_search",
"output": {
"count": "int",
"results": "[{name,id,projectName,lastModified}]"
},
"statusVerb": null,
"summary": "Server-indexed search across the whole team hub: about 20-30 s hub-wide, a few seconds with projectId (not a 30-min folder walk). Budget 120 s. A ZERO from the server index is not absence: the reply then carries data.fallback (a name scan of the newest 400 items), data.completeness, and a hint to fusion_aps_browse a known sibling's folder (issue #85).",
"timeoutSeconds": 120
},
{
"example": {
"exe": "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe",
"name": "Edge",
"profileDir": "Default"
},
"input": {
"exe": "str (browser binary) OR how:'extension'",
"how": "optional 'extension'|'launch'",
"name": "optional str",
"profileDir": "optional str"
},
"longRunning": false,
"name": "fusion_aps_set_browser",
"output": {
"browser": "{name,exe,profileDir}",
"success": "bool"
},
"statusVerb": null,
"summary": "Remember the browser+profile that authed to Autodesk so every later sign-in reuses it (power users have many browsers/profiles; the OS default is usually the wrong one). Call after a driven sign-in succeeds.",
"timeoutSeconds": 10
},
{
"example": {
"clientId": "D5nn...EPAq"
},
"input": {
"clientId": "required str"
},
"longRunning": false,
"name": "fusion_aps_set_client_id",
"output": {
"success": "bool"
},
"statusVerb": null,
"summary": "Set the org's APS (PKCE) client id used for cloud search. Get it from your org's members-only wiki settings: adom-wiki settings get <org> autodesk-aps (never from another machine's config file). When the org has none yet, the reply's hint gives the adom-wiki settings set command that shares it, so every other box adopts it in two calls (fusion-aps-org-setup skill). Public identifier, no secret.",
"timeoutSeconds": 20
},
{
"example": {},
"input": {
"allowDefaultBrowser": "optional bool",
"exe": "optional str (browser binary to launch+remember)",
"name": "optional str",
"profileDir": "optional str (e.g. 'Default','Profile 2')"
},
"longRunning": false,
"name": "fusion_aps_signin",
"output": {
"authUrl": "str",
"needsExtensionOpen": "bool",
"openedVia": "str",
"success": "bool"
},
"statusVerb": "fusion_aps_status",
"summary": "Open the Autodesk sign-in in the REMEMBERED browser+profile (not the OS default); a background listener captures the token. Pass {exe,profileDir,name} to use+remember a specific browser, or {allowDefaultBrowser:true} to fall back to the OS default. If nothing is remembered, returns needsExtensionOpen so the caller opens authUrl in the user's real browser via nbrowser_open_window.",
"timeoutSeconds": 30
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_aps_status",
"output": {
"configured": "bool",
"neverCharge": "bool",
"signedIn": "bool"
},
"statusVerb": null,
"summary": "APS state: configured, signed in, token live, never-charge meter. When configured:false the hint sends you to your org's shared app ID on the wiki (adom-wiki settings get <org> autodesk-aps) before anything else; the fusion-aps-org-setup skill covers new boxes and first-time orgs.",
"timeoutSeconds": 20
},
{
"example": {
"folderId": "urn:...",
"localPath": "C:/x.f3d",
"projectId": "a.YnVz..."
},
"input": {
"fileName": "optional str",
"folderId": "required str (NON-ROOT subfolder)",
"localPath": "required str",
"projectId": "required str"
},
"longRunning": false,
"name": "fusion_aps_upload",
"output": {
"bytes": "int",
"itemUrn": "str"
},
"statusVerb": null,
"summary": "Upload a local file as a NEW cloud file (free Data Management; needs data:write scope). \u26d4 FOLDER HYGIENE: NEVER pass a project ROOT folderId - the bridge REFUSES it (refused_root_upload). Loose files in a shared root clutter the team's cloud. Create/choose a real subfolder first (fusion_aps_create_folder under an 'Adom AI Workspace' folder), or just use fusion_make_3d_package / fusion_build_library_3d which auto-target a non-root workspace. To RELOCATE an existing file, MOVE it (preserves its urn) - do NOT delete + re-upload (mints a new urn, breaks 3D bindings). See the fusion-cloud-hygiene skill.",
"timeoutSeconds": 90
},
{
"example": {
"query": "BME690 Molecule"
},
"input": {
"query": "str OR projectId+urn"
},
"longRunning": false,
"name": "fusion_aps_versions",
"output": {
"versionCount": "int",
"versions": "[...]"
},
"statusVerb": null,
"summary": "Full (uncapped) version history of a file.",
"timeoutSeconds": 40
},
{
"example": {
"includePhysicalProperties": true,
"treatAsUnit": [
"with fasteners"
]
},
"input": {
"exclude": "optional [str] top-level name prefixes to skip",
"includePhysicalProperties": "optional bool (adds volume_cm3/mass_kg per line)",
"maxSeconds": "optional float (walk budget, default 20; the verb REFUSES fast with bom_walk_budget_exceeded + a fusion_export_bom redirect on electronics 3D PCBs instead of blocking Fusion for minutes - issue #659)",
"outputPath": "optional str (Windows CSV path)",
"treatAsUnit": "optional [str] name substrings counted as one unit (default ['with fasteners'])"
},
"longRunning": false,
"name": "fusion_assembly_bom",
"output": {
"design": "str",
"partCount": "int",
"parts": "[{componentName, partNumber, description, material, quantity, bodies}]",
"success": "bool",
"totalInstances": "int"
},
"statusVerb": null,
"summary": "Structured, kit-aware MECHANICAL bill of materials for the active Design assembly (the counterpart to the electronics-only fusion_export_bom). Recurses organizational subassemblies but counts a physical part or a purchased kit/unit ONCE, so hardware modeled inside a kit (a '... with fasteners' bracket, a bearing/pulley) is NOT double-counted the way a flat allOccurrences walk counts it. Matches Fusion's Manage -> BOM quantities. Optionally writes a CSV.",
"timeoutSeconds": 120
},
{
"example": {
"filePath": "C:/Users/<user>/adom-lib/ADS8588SIPM.fusion.lbr",
"modelPath": "C:/Users/<user>/adom-lib/ADS8588SIPM.step",
"packageName": "ADS8588SIPM"
},
"input": {
"filePath": "required str (.lbr WINDOWS path C:/...)",
"modelPath": "required str (.step WINDOWS path C:/...)",
"packageName": "optional str"
},
"longRunning": true,
"name": "fusion_attach_3d_package",
"output": {
"_hint": "the Save-dialog click + verify steps",
"data": "{steps}",
"savePending": "bool",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "LOW-LEVEL primitive: attaches ONE model to ONE package. Prefer fusion_create_library with parts[]. Attach a real 3D chip model to a library package, end to end: opens the .lbr (library active), runs Electron.Create3DPackage to enter the Package3DEnvironment showing the footprint, imports the STEP + auto-orients it flat on the footprint, then executes Package3DStop (FINISH). This BINDS the 3D onto the deviceset (Content Manager shows the 3D nested under the package; the Packages 'Package' column flips Placeholder->part-name). ONE desktop-side step remains: Fusion pops a modal Save dialog (an OWNED popup) - the response _hint gives the exact desktop_ui_click to confirm it. AFTER: re-grab desktop_screenshot_window and check ownedPopupCount for errors; the 3D preview LAGS a beat before showing the real chip. Both paths (filePath/modelPath) are WINDOWS paths - stage from the container first.",
"timeoutSeconds": 240
},
{
"example": {
"libraryPath": "C:/Temp/PART.lbr",
"stepPath": "C:/Temp/PART.step"
},
"input": {
"deviceset": "optional str (defaults to the library's first)",
"libraryPath": "required str (WINDOWS .lbr path)",
"stepPath": "required str (WINDOWS .step path)"
},
"longRunning": true,
"name": "fusion_bind_library_3d",
"output": {
"bound": "bool",
"reopened": "bool",
"success": "bool",
"wip_urn": "str"
},
"statusVerb": null,
"summary": "LOW-LEVEL primitive: binds ONE STEP onto one deviceset. Prefer fusion_create_library with parts[] (which handles one part or many through a single path); reach for this only when you are driving a single bind deliberately. The CORRECT library in ONE call (the Library button's real bar: the 3D chip renders in the Content Manager preview): mints the part's 3D as a cloud f3d (make_3d_package), injects the wip_urn binding into the .lbr ON DISK (packages3d + package3dinstances), and reopens the library. Needs a signed-in Fusion session - the one cloud-dependent step in the wiki-to-EE circle. Autodesk's thumbnail preview lags ~2-3 min behind a fresh mint. NOTE: distinct from the older fusion_build_library_3d (multi-part batch pipeline).",
"timeoutSeconds": 480
},
{
"example": {},
"input": {
"expectDocument": "required exact board name",
"outputDir": "optional folder on this machine for bom.csv + bom-jlcpcb.csv"
},
"longRunning": false,
"name": "fusion_board_bom",
"output": {
"boardOnly": "[str]",
"csv": "str",
"files": "{name:path}",
"jlcpcbCsv": "str",
"lines": "[{designators,quantity,value,package,mpn,manufacturer,mouser,digikey,lcsc}]",
"missingPartNumbers": "{mouser,digikey,lcsc:[str]}"
},
"statusVerb": "fusion_routing_state",
"summary": "The bill of materials from the live board's own part attributes: one line per MPN with designators, quantity, value, package, manufacturer and the Mouser, DigiKey and LCSC numbers, plus the JLCPCB form (Comment, Designator, Footprint, LCSC). Board-only parts (test pads) are listed as such, and any part missing a distributor number is named. Read-only; with outputDir it also writes bom.csv and bom-jlcpcb.csv there.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_board_info",
"output": {
"rawXml": "str"
},
"statusVerb": null,
"summary": "Raw board geometry XML (copper/arcs/lines) for the open board.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"fixed": "optional [{ref, deviceset, value?, x, y (mm, board frame), rot?, nets:{pin:net}}]",
"libraryPath": "required .lbr on this machine",
"name": "optional design name (letters, digits, _ -)",
"outDir": "required folder on this machine",
"outlineMm": "required [width, height]",
"rules": "optional {clearance, edge, minWidth, minDrill, holeToHole, padRestringRatio, padRestring, viaRestring, copperUm}",
"title": "optional sheet title"
},
"longRunning": false,
"name": "fusion_board_seed",
"output": {
"brdPath": "str",
"fixedParts": "int",
"schPath": "str"
},
"statusVerb": "fusion_get_app_state",
"summary": "Write the design a new board starts from, as EAGLE source on this machine: the board outline, the fab's design rules (Fusion's own rules block with your clearance, edge distance, minimum width and drill, hole-to-hole, pad and via restring and copper weight; Fusion's defaults are 0.35 mm drill, 1 mm to the edge and a 25 % pad restring, wrong for most fabs), the fixed parts at their places with their nets, and the library they come from. Then fusion_new_electronics_from_eagle imports it as a linked schematic and board.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"boardId": "optional",
"expectDocument": "required exact board name"
},
"longRunning": false,
"name": "fusion_board_source",
"output": {
"boardId": "str",
"revision": "str",
"source": "str (EAGLE .brd XML)"
},
"statusVerb": "fusion_routing_state",
"summary": "Read the live board as EAGLE XML from a fresh export: parts, copper, vias, pours with Fusion's own computed fill, and the outline. Read-only. Feed it to adom-fields (it reads .brd) for current and heat, or to adom-aiflow, which converts it for its offline checks.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_board_stackup",
"output": {
"copperCount": "int",
"copperLayers": "list",
"copperThickness_mm": "list",
"dielectricBonds": "list (prepreg/core order)",
"fr4": "{x_mm,y_mm,dielectric_mm}",
"layerSetup": "str"
},
"statusVerb": null,
"summary": "Read a board's PHYSICAL fabrication stackup (see the pcb-stackup skill): copper layer count + copper/dielectric thicknesses from the EAGLE design rules (layerSetup/mtCopper/mtIsolate) plus the measured FR4 extent. A PCB is Cu/prepreg/Cu/core/.../Cu - the FR4 is NOT one slab. Use to build the stackup table + real-thickness exploded 3D view, and put a stackup table on every exported board's wiki page.",
"timeoutSeconds": 200
},
{
"example": {
"lbrPath": "C:/tmp/newlib/AdomBasicParts2.lbr",
"parts": [
{
"lbrPath": "C:/tmp/newlib/R_4k7.lbr",
"modelPath": "C:/tmp/newlib/R_4k7.step",
"package": "R_4k7"
}
]
},
"input": {
"capture": "optional bool (default true)",
"folderId": "optional str",
"lbrPath": "required str (combined .lbr WINDOWS path to bind + open)",
"openWhenDone": "optional bool (default true)",
"outLbrPath": "optional str (default: overwrite lbrPath)",
"parts": "required [{package, lbrPath (per-part footprint .lbr), modelPath (.step)}]",
"projectId": "optional str"
},
"longRunning": true,
"name": "fusion_build_library_3d",
"output": {
"boundLbr": "str",
"opened": "bool",
"parts": "[{package,success,wip_urn,dims_mm,error}]",
"partsBound": "int",
"partsTotal": "int",
"screenshots": "[{package,stage,path}]",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Build a RENDERING multi-part 3D library in ONE call - the whole programmatic pipeline. For each part it makes the footprint+chip f3d package (no GUI dialogs, optional before/after screenshots) and collects the wip_urn, then injects ALL bindings into the combined .lbr in one pass (no hand XML surgery) and opens the finished library once. This is the verb for a basic-parts sampler / any many-part library; it replaces the per-part make_3d_package loop + manual binding. projectId/folderId default to the MAIN-project upload folder. Each part is independent, so re-run just the failed parts if Fusion resets mid-run.",
"timeoutSeconds": 1800
},
{
"example": {
"runId": "a3f1c2d4e5b6"
},
"input": {
"runId": "optional str (omit for the latest run in flight)"
},
"longRunning": true,
"name": "fusion_cancel_run",
"output": {
"cancelRequested": "bool",
"runId": "str",
"stage": "str at the time of the request",
"statusVerb": "fusion_prove_result"
},
"statusVerb": "fusion_prove_result",
"summary": "STOP a library import that is in flight (fusion_install_library_bundle / fusion_create_library) - the user's escape hatch from a long run, wired to a Cancel button in web control. Cooperative, not a kill: the run finishes the part it is on (a STEP import cannot be interrupted mid-command without leaving a half-made design, up to ~60s), keeps every 3D package already minted and binds them into the library, closes its scratch documents, and leaves the library open in Fusion (not saved to the cloud). The run then reports stage:cancelled, verdict:cancelled, errorCode cancelled_by_user, cancelledAt (which stage) and how many parts were done, on the same fusion_prove_result poll the caller already makes; cancelRequested:true shows on the very next poll before the boundary is reached. Omit runId to cancel the latest run still in flight. Idempotent; a run that already ended answers alreadyFinished.",
"timeoutSeconds": 10
},
{
"example": {
"packages": [
"ESP32-S3FN8",
"ATSAMD51J20A-AUT"
]
},
"input": {
"libraryPath": "optional str (.lbr on the box; required for the 3d view, defaults to the last library opened)",
"packages": "required [<deviceset name>] (or 'package': single name)",
"settle": "optional float secs after each EDIT before capture (default 1.5; raise if a shot shows the PREVIOUS part)",
"views": "optional subset of ['symbol','footprint','3d','component'] (default ALL FOUR, in that assembly order - 3d opens the part's BOUND f3d (footprint + chip) by its urn, frames it, captures it and closes it unsaved; needs libraryPath; component is the ganged view last)"
},
"longRunning": true,
"name": "fusion_capture_library_views",
"output": {
"captured": "[{package,view,path,ok}]",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Capture the LIBRARY-EDITOR views EEs trust: the schematic SYMBOL (full pinout), the FOOTPRINT (pads + layer stack), and the COMPONENT/device view (Content Manager: symbol + the package table with the footprint<->package Mapped check + pin/pad counts). The 3D before/after shots don't show these. Requires the .lbr OPEN in the Electronics Library workspace (fusion_open_lbr first). Runs EDIT <pkg>.sym/.pac/.dev + WINDOW FIT + a background hwnd screenshot per view; returns the PNG paths on the box (C:/tmp/conduit-screenshots - pull with desktop_pull_file). EDIT uses the DEVICESET name (e.g. ESP32-S3FN8).",
"timeoutSeconds": 300
},
{
"example": {},
"input": {
"boardId": "required",
"expectDocument": "required exact board name",
"expectedRevision": "required",
"pours": "required [{net, layer, points:[[x,y]...], width? (mm), isolate? (mm)}]"
},
"longRunning": false,
"name": "fusion_change_pours",
"output": {
"changes": "[{net,layer,width:[before,after],isolate:[before,after],filledMm2:[before,after]}]",
"revision": "str",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Change existing pours in place: the pen width (the narrowest copper the fill can reach; a pen wider than a throat leaves it empty) and the isolation. Each pour is named by net, layer and outline, picked on the midpoint of its longest edge, then RATSNEST refills. The readback proves each pour took its new width/isolate and that no track or via changed, and reports the filled area before and after.",
"timeoutSeconds": 120
},
{
"example": {
"fileName": "BQ25792",
"folderPath": "Molecules/XRP/Power",
"projectName": "Main"
},
"input": {
"fileName": "required str",
"folderPath": "optional str (default the project root)",
"projectName": "optional str (default the active project)"
},
"longRunning": false,
"name": "fusion_check_recovery",
"output": {
"apiReliable": "bool",
"fileId": "str",
"fileName": "str",
"hasRecovery": "bool",
"project": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Ask whether a cloud file has a crash-recovery document waiting, which would raise Fusion's recovery modal on open. BEST-EFFORT: Fusion's Python API does not reliably expose this (apiReliable reports whether the property existed), so a false negative is possible; the dependable signal is an open that times out, and fusion_dismiss_blocking_dialogs clears the modal. Finds the file by exact name in one project folder.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"profile": "optional str (browser profile to name in the sign-in hint, e.g. edge:[email protected])"
},
"longRunning": false,
"name": "fusion_claim_seat",
"output": {
"account": "obj",
"holdsSeat": "bool",
"license": "obj",
"steps": "[{step, ok}]",
"success": "bool"
},
"statusVerb": "fusion_readiness",
"summary": "Make THIS machine the active Fusion seat, the first-class way to move a licence between boxes while testing. Starts Fusion if needed, then answers Autodesk's 'Active Sessions Exceeded' modal in the BACKGROUND (Continue): this box takes the seat and the other machine's Fusion suspends RESUMABLY, keeping its documents. Answers needs_signin (never a credential prompt) when the box is not signed in: run fusion_signin first. Confirms with fusion_account and reports the account and licence it ended up with.",
"timeoutSeconds": 300
},
{
"example": {
"fileIds": [
"urn:adsk.wipprod:dm.lineage:abc123"
],
"projectName": "Adom"
},
"input": {
"fileIds": "required [<lineage urn>]",
"folderPath": "optional str (default root - where the files live)",
"projectName": "optional str (default active project)"
},
"longRunning": true,
"name": "fusion_cleanup_cloud_files",
"output": {
"deletedCount": "int",
"failed": "[{fileId,error}]",
"failedCount": "int",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "PRECISELY delete a list of cloud files by lineage urn - SAFE cleanup of AI-created clutter. Deletes ONLY the exact fileIds given (never name-guessing), so it can't touch a teammate's file in a shared folder. Loops server-side. Get the ids from fusion_aps_browse (item .id). Use this to remove f3d files the bridge created. A big list takes minutes (relay may time out at ~60s while deletes continue server-side - re-browse to confirm).",
"timeoutSeconds": 1800
},
{
"example": {
"closeUntitled": true
},
"input": {
"closeUntitled": "optional bool default false - also close UNMODIFIED Untitled scratch docs",
"force": "optional bool default false - with closeUntitled, also discard MODIFIED Untitled docs",
"save": "optional bool default false"
},
"longRunning": false,
"name": "fusion_close_all_documents",
"output": {
"closed": "[str]",
"success": "bool",
"wouldPrompt": "[str]|null"
},
"statusVerb": null,
"summary": "Close ALL open documents without save dialogs. DESTRUCTIVE to unsaved user work - confirm with the human before calling on a box you do not own. By default it SKIPS scratch 'Untitled' docs; pass closeUntitled:true to close the UNMODIFIED ones too (page issue #59: the library/bind flow left ~5 per import, 16 after three, and no caller could clear them), and force:true to also discard MODIFIED Untitled docs, which may hold real unsaved work.",
"timeoutSeconds": 60
},
{
"example": {
"save": false
},
"input": {
"name": "optional str (default: active document)",
"save": "optional bool default false"
},
"longRunning": false,
"name": "fusion_close_document",
"output": {
"closed": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Close ONE document WITHOUT the modal save dialog (save:false discards silently - the automation-safe close). Omit name to close the active document.",
"timeoutSeconds": 60
},
{
"example": {
"hwnd": 123456
},
"input": {
"hwnd": "required int (the dialog window)"
},
"longRunning": false,
"name": "fusion_close_window",
"output": {
"success": "bool"
},
"statusVerb": null,
"summary": "Close a DIALOG window by hwnd (WM_CLOSE, like clicking X) - for dialogs without Cancel/Escape handling (e.g. Recovered Documents). NOT a document closer; refuses without hwnd. Get the hwnd from a screenshot's dialogs array or desktop_list_windows. (Doc drift caught by the verb test suite 2026-08-14: this was described as 'close the active document' while the handler required hwnd.)",
"timeoutSeconds": 30
},
{
"example": {
"folderName": "AI-Scratch",
"projectName": "Main"
},
"input": {
"folderName": "required str",
"parentPath": "optional str (parent folder path; default the project root)",
"projectName": "optional str (default the active project)"
},
"longRunning": false,
"name": "fusion_create_cloud_folder",
"output": {
"alreadyExisted": "bool (only when it already existed)",
"folderId": "str",
"folderName": "str",
"parentFolder": "str",
"project": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Create a subfolder in a cloud project through the signed-in Fusion session's Data API (no APS needed). Idempotent: an existing folder of that name is returned with alreadyExisted:true instead of a duplicate. Folder names are matched case-insensitively. For an APS-side create without Fusion running, use fusion_aps_create_folder.",
"timeoutSeconds": 60
},
{
"example": {
"libraryPath": "C:/Temp/PART.lbr",
"stepPath": "C:/Temp/PART.step"
},
"input": {
"kicadFootprintPath": "optional str",
"kicadSymbolPath": "optional str",
"libraryPath": "optional str (shape A, or output path for B)",
"name": "optional str",
"parts": "optional [{package, lbrPath, modelPath}] - THE canonical shape, any count",
"pinMap": "optional {pinName: padName}",
"stepPath": "optional str (required for proven)"
},
"longRunning": true,
"name": "fusion_create_library",
"output": {
"started": "bool",
"statusVerb": "str"
},
"statusVerb": "fusion_prove_result",
"summary": "ONE-CALL library creation for web-control (one call = one consent). EVERY LIBRARY IS MULTI-PART - a single-part library is simply parts:[one entry], and there is no separate single-part verb to choose. Pass parts:[{package, lbrPath, modelPath}] for any number of parts; the older {libraryPath, stepPath} shape still works and is normalised into a one-element parts list, so both run the identical code path and the ETA scales with the part count either way. TWO entry shapes: A) {libraryPath, stepPath} - a ready .lbr plus the 3D; B) {kicadSymbolPath, kicadFootprintPath, stepPath, pinMap?} - KiCad sources; needs adom-lbr, which is Linux-container-only by platform rule, so on Windows/Mac boxes shape B refuses IMMEDIATELY (adom_lbr_unavailable, before any staging or Fusion launch - fusion_readiness reports kicadIngest up front). Convert at AUTHORING time in a container and use shape A. pinMap = explicit {pinName: padName} for when pin numbers do not match pad names (BGA-style). Chains convert -> bind 3D -> prove (four evidence frames + verdict) in the BACKGROUND and returns immediately; poll fusion_prove_result (stage narrates; top-level `verdict` proven/not_proven is the score - `stage:done` only means the chain finished). EVERY PART IS PROVED, not just the first: a 10-component library streams 40 evidence frames, FOUR per component (symbol, footprint, 3d, ganged) in assembly order, each tagged with `part` so a front end can group them as they arrive, and `provedParts[]` reports per-part pass/fail. The library is proven only if EVERY part is - one good part does not vouch for nine unchecked ones. On the FINAL fetch pass {inlineFrames:true} to get each evidence frame as a base64 thumbnailDataUrl a browser can render (plain polls return box paths only). The chain closes its library document on success AND failure - batches need no between-part sweeping. stepPath is required for a PROVEN library - no real 3D body without it.",
"timeoutSeconds": 30
},
{
"example": {
"fileName": "verbtest-scratch",
"folderPath": "AI-Scratch",
"projectName": "Main"
},
"input": {
"fileId": "optional str (lineage urn for a precise delete; lineageUrn is accepted as an alias)",
"fileName": "required str unless fileId is given (exact name match in one folder)",
"folderPath": "optional str (default the project root)",
"projectName": "optional str (default the active project)"
},
"longRunning": false,
"name": "fusion_delete_cloud_file",
"output": {
"fileId": "str",
"fileName": "str",
"folder": "str",
"project": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "DESTRUCTIVE: delete ONE cloud file through the signed-in Fusion session's Data API. Looks in exactly one folder (projectName + folderPath, no recursion) for an exact case-insensitive name match, or for the lineage urn when fileId is given (the precise form; prefer it in shared folders). Refuses without fileName or fileId. Large folders time out on the scan; give a precise folderPath. Use fusion_cleanup_cloud_files to delete a LIST of urns with dryRun support.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"captions": "optional bool (default true: one desktop caption per stop)",
"foreground": "optional bool (default false: background envelope, never steals focus)",
"mode": "optional str ('tour' = the async showcase; poll fusion_demo_progress {demoId})",
"preset": "optional str ('electronics' = library import, symbol, footprint, 3D chip, ganged component view, schematic, 2D board, 3D board - the eight-stop showcase; omit for the full tour incl. Data Hub, APS, MCP, exports)",
"query": "optional str (design to demo; else picked from APS search)",
"remote": "optional bool (tour mode: show ab's floaty glass PLAY/PAUSE/NEXT/BACK/STOP panel on the desktop; its presses drive the same transport flags as fusion_demo_control, so the dashboard buttons and the remote can be mixed)",
"stage": "optional str ('skip_aps' to proceed without cloud search)"
},
"longRunning": true,
"name": "fusion_demo",
"output": {
"apsSampleSearch": "[{name,project}]",
"done": "bool",
"narrate": "str",
"screenshots": "[{label,path}]",
"stage": "str",
"steps": "[str]"
},
"statusVerb": "fusion_demo",
"summary": "FIRST-TIME-USER DEMO in one verb - the thing to run when someone new wants to SEE what this bridge does (HD's installer calls this). Takes them from nothing to a real board: launches Fusion, FINISHES the Autodesk sign-in - it OPENS the sign-in in the user's NATIVE browser IN THE BACKGROUND (never interrupting their work) and returns signinWhere/signinProfile/signinSession so you can tell them exactly where it is waiting, then offer three paths: they finish it, you foreground it, or (with their OK) you drive it. Native browser via ABE/nbrowser_* because that profile is already signed into Autodesk - never pup, which is anonymous, sets up APS cloud search (or explains it if declined) and runs a LIVE sample search so they see 2-second results, then opens an electronics PROJECT and walks SCHEMATIC -> 2D BOARD -> 3D BOARD, screenshotting each view to show them. STAGED + RESUMABLE: every call advances as far as it safely can and returns stage/done/narrate/screenshots plus a _hint with the exact next action; keep calling it until done:true. NEVER leave a first-time user parked on the sign-in screen - that is the failure this verb exists to prevent. See the 'fusion-demo' skill. TOUR MODE: pass {mode:'tour'} for the ASYNC guided ELECTRONICS tour (John, 2026-09-04: Adom is an electronics prototyping company, so the tour shows electronics, never a mechanical part): eight beats over the bundled sample part - the library, the symbol, the footprint, the 3D chip minted from its STEP and bound into the user's hub, then a REAL board from the user's hub (BQ25792, the Adom charger; args.board or args.boardUrn override) in schematic, 2D board and 3D board, falling back to a generated solo board only when the hub has none, and a cloud search; multipart libraries are mentioned in the narration, never shown (a bind is minutes per part). Captions are 32px on one line so they never cover the remote. ab's glass remote (desktop_demo_panel id fusion-tour) drives it: play, pause, next, back, mute, unmute, X = stop, with an instant loopback callback plus a poll backstop, one FIFO for the panel and fusion_demo_control, an ack caption per press; captions narrate every beat and pre-rendered narration audio plays locally (mute is session-only, unmute replays the beat). Every beat is measured before it moves (front, title, painted, stable) and then moves (2D zoom through the add-in, 3D orbit and zoom through Fusion's camera, verified by capture). Returns {demoId, estimatedSec, steps} at once; fusion_demo_progress {demoId} carries step, beatIndex/beatCount, percent, paused, muted, stopping, panel, presses[], captions[], per-step verified/placed/foregrounded/motion, shots[] (one evidence frame per beat), windowsRestored and tourDocsClosed. Fusion is placed on 80% of the primary work area for the show and restored at the end. Pass legacy:true for the previous step-list tour.",
"timeoutSeconds": 240
},
{
"example": {
"demoId": "tour-abc123",
"imagesAs": "base64",
"sinceShot": 3
},
"input": {
"demoId": "required str (from fusion_demo mode:tour; omitted = the single running tour)",
"imagesAs": "optional str paths|base64|both",
"sinceShot": "optional int - shots you already received; response windows to the new ones"
},
"longRunning": false,
"name": "fusion_demo_progress",
"output": {
"done": "bool",
"percent": "int",
"shotCount": "int",
"shots": "list",
"step": "str",
"stepLabel": "str",
"stepShot": "dict|absent"
},
"statusVerb": null,
"summary": "Poll a running fusion_demo tour: {percent, elapsedSec, estimatedSec, step, stepLabel, done, failed, shots, shotCount, stepShot}. Poll ~1-2.5s and render a REAL progress bar. LIVE EVIDENCE (issue #30): each frame MAY carry stepShot {step, title, image} - a ~640px base64 capture the BRIDGE took at that step's completion, one per step, riding the first frame after it completes (render these during the run; the page should not guess-snap). shots[] streams too: mid-run it carries paths for every completed step; pass imagesAs:base64 + sinceShot:<count you have> to receive only NEW shots fully encoded. done:true = the full gallery (base64 by default). Finished tours are DISK-SNAPSHOTTED, so the final frame stays pollable even across a bridge respawn.",
"timeoutSeconds": 15
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_describe",
"output": {
"success": "bool",
"verbs": "[{name,summary,input,output,timeoutSeconds,statusVerb,longRunning,example}]"
},
"statusVerb": null,
"summary": "Self-describe every verb the bridge exposes (this list) for ab's Verbs tab + runner. The reply carries `contribute` (source, mirror, issue and PR commands, the fusion-contributing skill); every failing reply carries `_contribute` with the same pointer.",
"timeoutSeconds": 20
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_detect_layers",
"output": {
"copperLayers": "[int]",
"layerCount": "int"
},
"statusVerb": null,
"summary": "Detect 2-layer vs 4-layer board (ULP + CAM comparison).",
"timeoutSeconds": 90
},
{
"example": {},
"input": {
"categories": "optional [str] dialog categories to act on (default: all blocking dialogs)"
},
"longRunning": false,
"name": "fusion_dismiss_blocking_dialogs",
"output": {
"count": "int",
"dialogs": "[...]",
"dismissed": "[{title, category, answeredWith, closed}]"
},
"statusVerb": null,
"summary": "Detect + classify (and optionally dismiss) blocking Fusion dialogs. Answers every one with the safe button (No/Cancel via WM_CLOSE, never Yes, never focus-stolen). {categories:[...]} narrows the sweep to those categories (e.g. [\"crash_report\"], the launch janitor's scope).",
"timeoutSeconds": 30
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_document_info",
"output": {
"isSaved": "bool",
"name": "str",
"productType": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Metadata for the ACTIVE document: name, product type, save state, version, parent project.",
"timeoutSeconds": 30
},
{
"example": {
"runId": "1a2b3c"
},
"input": {
"runId": "required str (from fusion_new_electronics_from_eagle)"
},
"longRunning": false,
"name": "fusion_eagle_import_status",
"output": {
"documentName": "str",
"partsExpected": "int",
"partsPlaced": "int",
"result": "obj",
"stage": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "The run record of a background fusion_new_electronics_from_eagle import: stage (started | done | failed), documentName, partsExpected (elements in the .brd), partsPlaced (read back from the board), placed[], and the final result. Poll it every few seconds after the import returned its runId.",
"timeoutSeconds": 20
},
{
"example": {
"x1": 0,
"x2": 10,
"y1": 0,
"y2": 8
},
"input": {
"frameDelayMs": "optional int (default 35)",
"steps": "optional int (default 16)",
"x1": "float",
"x2": "float",
"y1": "float",
"y2": "float"
},
"longRunning": true,
"name": "fusion_electron_pan",
"output": {
"box": "[...]",
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Smoothly PAN + zoom the view to frame a board-coordinate box (mm; get part positions from fusion_board_info). Animates from where the view last was.",
"timeoutSeconds": 60
},
{
"example": {
"command": "set confirm yes;RUN 'C:/tmp/jlcpcb_smta_exporter.ulp' 'C:/tmp/jlc'"
},
"input": {
"command": "required str"
},
"longRunning": false,
"name": "fusion_electron_run",
"output": {
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Run an EAGLE/Electron command in the open board (the generic extension point, e.g. RUN <ulp>).",
"timeoutSeconds": 90
},
{
"example": {
"name": "U1"
},
"input": {
"name": "str (refdes, e.g. R1)",
"properties": "optional bool (default true)",
"x": "optional float",
"y": "optional float"
},
"longRunning": true,
"name": "fusion_electron_select",
"output": {
"deviceInfo": "str",
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "SELECT a part (by reference designator, or x/y board mm) and surface its properties - the way clicking a part reveals the properties panel. Great for showing life in a recording.",
"timeoutSeconds": 30
},
{
"example": {
"factor": 3,
"steps": 20
},
"input": {
"factor": "float (default 2.0)",
"fit": "optional bool",
"frameDelayMs": "optional int (default 35)",
"steps": "optional int (default 16)"
},
"longRunning": true,
"name": "fusion_electron_zoom",
"output": {
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Smoothly ZOOM the schematic/2D board for a recording (the whole motion is one call). factor>1 zooms in, <1 out; or fit:true. The loop runs in the add-in with a repaint per frame.",
"timeoutSeconds": 60
},
{
"example": {
"entity": "Element",
"fields": [
"name",
"x",
"y",
"angle"
]
},
"input": {
"entity": "required str (class name, with or without the electronics. prefix)",
"fields": "optional [str] property names to return",
"filters": "optional [{property, op: eq|lt|gt, value}] (strings: eq only)",
"limit": "optional int (default 100)",
"offset": "optional int",
"source": "optional auto|mcp|board (default auto)"
},
"longRunning": false,
"name": "fusion_electronics_query",
"output": {
"count": "int",
"entity": "str",
"rows": "[dict]",
"source": "mcp|board",
"success": "bool",
"total": "int"
},
"statusVerb": "fusion_get_app_state",
"summary": "TYPED electronics read model: rows for one of Autodesk's 49 electronics entity classes (Element, Signal, Net, Layer, Via, Smd, Wire, Pad, Part, Instance, Pin, Sheet, Package, Library, Error, Variant...) over the ACTIVE electronics document, with filters, field projection and pagination. Served by Autodesk's own MCP electronics_read when its server answers (fusion_mcp_enable turns it on), else by the board_info geometry export for Board/Element/Library/Package/Layer/Signal/Wire/Error (coordinates in mm). `source` names which. Replaces reading board_info XML by hand.",
"timeoutSeconds": 120
},
{
"example": {
"command": "Electron.ImmediateRepaint /full"
},
"input": {
"command": "required str",
"expectDocument": "optional str (refuses wrong_document if the active doc does not match)"
},
"longRunning": false,
"name": "fusion_execute_text_command",
"output": {
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Run a raw Fusion TEXT COMMAND (app.executeTextCommand) - the escape hatch to Fusion internals (Electron.* electronics commands included). Electron.* commands need an ELECTRONICS document context (schematic/board view active). Guard risky calls with expectDocument.",
"timeoutSeconds": 60
},
{
"example": {
"outputPath": "C:/out/part.3mf"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_3mf",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to 3MF mesh.",
"timeoutSeconds": 300
},
{
"example": {
"dpi": 300,
"outputPath": "C:/Temp/board-assembly-top.png",
"preset": "assembly_top"
},
"input": {
"dpi": "optional int (default 300, max 600)",
"layers": "optional [int] (EAGLE layer numbers; overrides preset)",
"listPresets": "optional bool (return the presets instead of exporting)",
"mirror": "optional bool (default false; accepted but not applied by the add-in today, the bottom-side mirror is done container-side)",
"monochrome": "optional bool (default false)",
"outputPath": "optional str (WINDOWS path; default C:/tmp/adom-board.png)",
"preset": "optional str (default all)"
},
"longRunning": true,
"name": "fusion_export_board_image",
"output": {
"activeWorkspace": "str",
"dpi": "int",
"fileSize": "int",
"fileSizeKB": "int",
"monochrome": "bool",
"nextSteps": "[str]",
"outputPath": "str",
"preset": "str (custom when layers given)",
"presetDescription": "str",
"presets": "{name: description} (listPresets form only)",
"success": "bool"
},
"statusVerb": null,
"summary": "Render the OPEN board (or schematic) to a PNG via EAGLE's EXPORT IMAGE with a layer preset: all, top_copper, bottom_copper, top_silkscreen, bottom_silkscreen, top_soldermask, bottom_soldermask, top_paste, bottom_paste, board_outline, drill, assembly_top, assembly_bottom, fabrication (or explicit EAGLE layer numbers). Requires an electronics editor to be active (fusion_show_2d_board or fusion_open_board first). Silkscreen presets fit the view to the board outline so the PNG maps onto the board bbox. Layer visibility is restored (DISPLAY ALL) afterwards. listPresets:true returns the preset table instead of exporting.",
"timeoutSeconds": 60
},
{
"example": {
"outputPath": "C:/tmp/bom.csv"
},
"input": {
"grouped": "optional bool (default true)",
"outputPath": "optional str"
},
"longRunning": false,
"name": "fusion_export_bom",
"output": {
"componentCount": "int",
"grouped": "bool"
},
"statusVerb": null,
"summary": "Export a Bill of Materials CSV (grouped by value+package) from the open board.",
"timeoutSeconds": 60
},
{
"example": {
"format": "step",
"outputPath": "C:/Temp/TJA1050.step"
},
"input": {
"format": "optional str (default step): step|stl|f3d|iges|sat|smt",
"outputPath": "required str (WINDOWS path on the Fusion machine)"
},
"longRunning": true,
"name": "fusion_export_cloud_file",
"output": {
"documentName": "str",
"fileSize": "int",
"format": "str",
"outputPath": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Export the ACTIVE Fusion Design document to a local file on the Fusion machine in one of step, stl, f3d, iges, sat or smt (despite the name it does not fetch a cloud file by name; open the document first with fusion_open_cloud_file). Requires a Design document to be active. For the per-format verbs with their own timeouts see fusion_export_step and friends; this is the one-verb form with a format switch. Pull the file back with pull_file.",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/tmp/cpl.csv"
},
"input": {
"outputPath": "optional str",
"side": "optional str (all|top|bottom)"
},
"longRunning": false,
"name": "fusion_export_cpl",
"output": {
"bottomCount": "int",
"topCount": "int"
},
"statusVerb": null,
"summary": "Export the Component Placement List (pick-and-place) CSV.",
"timeoutSeconds": 60
},
{
"example": {
"outputPath": "C:/out/sketch.dwg"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_dwg",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export 2D DWG.",
"timeoutSeconds": 120
},
{
"example": {
"outputPath": "C:/out/sketch.dxf"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_dxf",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export 2D DXF.",
"timeoutSeconds": 120
},
{
"example": {
"outputPath": "C:/Temp/TJA1050.brd"
},
"input": {
"outputPath": "required str (WINDOWS path ending in .sch or .brd)"
},
"longRunning": false,
"name": "fusion_export_eagle_source",
"output": {
"activeDocument": "str",
"activeWorkspace": "str",
"format": "str (sch|brd)",
"innerZipEntry": "str",
"savedTo": "str",
"sizeBytes": "int",
"success": "bool"
},
"statusVerb": null,
"summary": "Export the ACTIVE electronics document as plain EAGLE XML (.sch or .brd; the outputPath extension picks the format). Fusion's .fsch/.fbrd are ZIP containers with the EAGLE XML inside; this exports the container via Document.CopyToDesktop, extracts the inner XML, writes it to outputPath and deletes the intermediate file. The result opens in standalone EAGLE, imports into KiCad, and parses with any XML tool. The container holds whichever editor is ACTIVE, so since 1.10.35 the bridge switches to it first (Schematic Editor for .sch, PCB Editor for .brd; reply carries switchedView) instead of answering 'No .sch file found inside .fsch ZIP container' (page issue #95).",
"timeoutSeconds": 60
},
{
"example": {
"outputPath": "C:/out/design.f3d"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_f3d",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export the active design as a Fusion archive (.f3d).",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/out/part.fbx"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_fbx",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to FBX mesh.",
"timeoutSeconds": 300
},
{
"example": {
"outputDir": "C:/tmp/jlc"
},
"input": {
"outputDir": "optional str (default C:/tmp/adom-gerbers)"
},
"longRunning": true,
"name": "fusion_export_gerbers",
"output": {
"fileCount": "int",
"files": "[{name,size}]",
"zipPath": "str"
},
"statusVerb": null,
"summary": "Run the bundled JLCPCB CAM job (auto 2/4-layer) to produce the gerber + drill ZIP.",
"timeoutSeconds": 180
},
{
"example": {
"outputPath": "C:/out/board.iges"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_iges",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to IGES.",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/Temp/TJA1050.scr"
},
"input": {
"outputPath": "optional str (WINDOWS path for the .scr; default a temp file on the Fusion machine)"
},
"longRunning": false,
"name": "fusion_export_lbr",
"output": {
"fileSize": "int",
"outputPath": "str",
"preview": "str (first 2000 chars)",
"success": "bool"
},
"statusVerb": null,
"summary": "Export the electronics LIBRARY in front as an EAGLE .scr script via Electron.run EXPORT SCRIPT: a text dump of every symbol, package and device, the round-trip check that a library loaded correctly. Requires an electronics editor to be active (fusion_open_lbr puts the library in front). Returns the path, size and the first 2000 characters as a preview; pull the file to read the rest.",
"timeoutSeconds": 60
},
{
"example": {
"outputPath": "C:/out/part.obj"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_obj",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to OBJ mesh.",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/out/board.glb"
},
"input": {
"async": "bool - RECOMMENDED true: fires the whole export+optimize pipeline in the background and returns {exportId} instantly (the sync form can outlive the relay window on a cold Fusion session); poll fusion_fetch_optimized_glb {exportId}",
"outputPath": "required str (.glb)",
"pin": "str medium|large default medium",
"silkscreen": "bool default true",
"wait": "int seconds default 15 (keep under the ~60s relay timeout; re-call fetch until complete)"
},
"longRunning": true,
"name": "fusion_export_optimized_glb",
"output": {
"glbPath": "str",
"jobId": "str",
"meshesAfter": "int",
"moleculeAnchored": "bool",
"pending": "bool",
"silkscreenApplied": "bool",
"sizeBytes": "int"
},
"statusVerb": null,
"summary": "Fusion board -> wiki-grade optimized GLB. Exports STEP (+ optional silkscreen) and submits it to service-step2glb molecule mode (anchor to MP pins + silk bake + gold pins + join/weld/prune + Draco): ~465KB/~31 draw calls vs a raw ~16MB/~25000 that halts the viewer. Bounded-waits `wait`s (default 90); small boards return complete, big boards return {pending, jobId} - finish with fusion_fetch_optimized_glb. Use for a component page's component.parts.model_3d. STACKUP RULE (John 2026-07-15, see pcb-stackup skill): board bbox = the FR4 body, NEVER the whole assembly (components overhang edges + tower above); each overlay goes at ITS layer's z (copper at FR4-top, silk above mask); copper traces are REAL 35um 3D bodies colored like the FR4 - recolor them + translucent mask in the RAW GLB before optimizing to make routing visible; put the measured stackup table on the board's wiki page. PUBLISH EVERYTHING: a board's wiki page repo must carry EVERY exportable design file (.f3d/.step/.usdz/EAGLE .brd+.sch/Fusion .fbrd+.fsch/gerbers/BOM/CPL/GLBs/renders), not just the 3D - the page exists to share the design.",
"timeoutSeconds": 200
},
{
"example": {
"outputPath": "C:/out/part.sat"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_sat",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to SAT (ACIS solid).",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/out/part.skp"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_skp",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to SketchUp (.skp).",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/Temp/TJA1050.fbrd"
},
"input": {
"outputPath": "required str (WINDOWS path ending in .fsch, .fbrd or .flbr)"
},
"longRunning": false,
"name": "fusion_export_source",
"output": {
"activeDocument": "str",
"activeWorkspace": "str",
"format": "str (fsch|fbrd|flbr)",
"savedTo": "str",
"sizeBytes": "int",
"success": "bool"
},
"statusVerb": null,
"summary": "Export the ACTIVE electronics document in Fusion's native source format via Document.CopyToDesktop: .fbrd (board), .fsch (schematic) or .flbr (library); the outputPath extension picks the format. The container holds whichever editor is ACTIVE, so since 1.10.35 the bridge switches to it first: the Schematic Editor for a .fsch, the PCB Editor for a .fbrd (reply carries switchedView). A .flbr still needs the library open (fusion_open_lbr). For plain EAGLE XML use fusion_export_eagle_source.",
"timeoutSeconds": 60
},
{
"example": {
"outputPath": "C:/out/board.step"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_step",
"output": {
"fileSizeKB": "int",
"format": "str"
},
"statusVerb": null,
"summary": "Export the active design to STEP (needs the 3D view).",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/out/part.stl"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_stl",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to STL mesh.",
"timeoutSeconds": 300
},
{
"example": {
"outputPath": "C:/out/part.usdz"
},
"input": {
"outputPath": "required str"
},
"longRunning": true,
"name": "fusion_export_usdz",
"output": {
"format": "str"
},
"statusVerb": null,
"summary": "Export to USDZ (AR / Hydrogen 3D).",
"timeoutSeconds": 300
},
{
"example": {
"jobId": "abc123",
"outputPath": "C:/out/board.glb"
},
"input": {
"exportId": "str (async form from export_optimized_glb async:true - returns {phase, done, glbPath} instantly per poll)",
"jobId": "str (service job form)",
"outputPath": "str (.glb)",
"wait": "int seconds default 15 (keep under the ~60s relay timeout; re-call fetch until complete)"
},
"longRunning": false,
"name": "fusion_fetch_optimized_glb",
"output": {
"glbPath": "str",
"pending": "bool",
"sizeBytes": "int",
"status": "str"
},
"statusVerb": null,
"summary": "Finish a fusion_export_optimized_glb job: bounded-poll the optimizer by jobId and write the GLB to outputPath when complete. Re-call until status=complete (big boards tessellate a few minutes). No Fusion needed.",
"timeoutSeconds": 150
},
{
"example": {
"etch": "103",
"outputStep": "C:/tmp/ADOM-R0603-103.step",
"params": {
"A": 0.45,
"D": 1.6,
"E": 0.8,
"L": 0.3,
"L1": 0.3
},
"type": "chip"
},
"input": {
"etch": "optional str (marking text on the chip top: MPN / '103'; multi-line with newline, e.g. MPN+variant - laid along the LONGEST face axis)",
"etchDepthMm": "optional float (marking height/depth, default 0.03)",
"etchHeightMm": "optional float (text height; default auto-fit: top-5%-band face, 10% margin, width-aware)",
"etchStyle": "optional str raised|engraved (default raised = thin WHITE positive extrude, silkscreen-style contrast; engraved = sunken cut)",
"outputStep": "optional str (WINDOWS path; exports STEP incl. the marking)",
"params": "optional dict (generator dims in MM by default, e.g. chip: {D,E,A,L,L1}; soic: {A,A1,b,D,E,E1,e,L,DPins}; omitted keys use EPG defaults)",
"type": "required str (EPG family, e.g. chip|soic|qfn|qfp|bga|sot23|dfn2|melf|ecap|crystal|header_straight - see supportedTypes in the error for the full list)",
"unitsCm": "optional bool (params already EPG-native cm)"
},
"longRunning": true,
"name": "fusion_generate_package",
"output": {
"bodies": "[{name,vol}]",
"epgDir": "str",
"etched": "str|null",
"manifest": "obj (settings+why+bboxes; also written as <step>.manifest.json sidecar for marking refreshes)",
"manifestPath": "str|null",
"stepPath": "str|null",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Generate an IPC-7351-compliant parametric 3D package via Fusion's BUILT-IN ElectronicsPackageGenerator (EPG) - ~50 package families (chip/soic/qfn/qfp/bga/sot23/dfn/melf/ecap/crystal/headers/...), each a few seconds, ZERO GUI. Optionally LASER-ETCH a marking (MPN / '103') into the body top as REAL cut geometry (survives STEP), and export STEP in the same call - the royalty-free, license-clean path to a whole component library (our own generated output, not vendor models). Proven live: 0603 + '103' etch + STEP in ~2s.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_get_app_state",
"output": {
"activeDocument": "str",
"activeWorkspace": "str",
"isElectronics": "bool"
},
"statusVerb": null,
"summary": "Current app state: running, active document, workspace, isElectronics. The poll/status verb for long-running calls.",
"timeoutSeconds": 20
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_get_design_info",
"output": {
"bodies": "int",
"components": "int",
"success": "bool"
},
"statusVerb": null,
"summary": "Design-level summary of the active design: components, bodies, sketches, units, root name.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_get_parameters",
"output": {
"parameters": "list",
"success": "bool"
},
"statusVerb": null,
"summary": "All user + model parameters of the active design (name, expression, value, unit).",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_get_preferences",
"output": {
"current": "obj"
},
"statusVerb": null,
"summary": "Read current Fusion appearance/navigation preferences (theme, activeTheme, invertScrollZoom, orbitScheme, modelingOrientation, gestureNav, cameraPivot, lengthUnit) as friendly values - the same keys fusion_set_preference accepts.",
"timeoutSeconds": 20
},
{
"example": {
"filePath": "C:/Temp/TJA1050.fbrd"
},
"input": {
"filePath": "required str (WINDOWS path to a .fsch, .fbrd or .flbr; must exist on the Fusion machine)"
},
"longRunning": true,
"name": "fusion_import_electronics",
"output": {
"activeDocument": "str",
"activeWorkspace": "str",
"extension": "str",
"filePath": "str",
"fileType": "str",
"nextSteps": "[str]",
"postOpenCheck": "{required, steps}",
"screenshots": "[{type,savedTo,sizeKB}] (sidecar shell) or postOpenScreenshot (exe shell)",
"success": "bool"
},
"statusVerb": null,
"summary": "Import a Fusion-NATIVE electronics file (.fsch schematic, .fbrd board, .flbr library; NOT legacy EAGLE .sch/.brd/.lbr) from the Fusion machine as a NEW local document via Document.newDesignFromLocal. The document is unsaved: fusion_save_to_cloud persists it, fusion_close_document discards it. The bridge captures a post-open screenshot because Fusion can raise a blocking dialog the API cannot see.",
"timeoutSeconds": 60
},
{
"example": {
"filePath": "C:/Temp/part.step"
},
"input": {
"filePath": "required str (WINDOWS path C:/...; stage from container first)"
},
"longRunning": true,
"name": "fusion_import_step",
"output": {
"documentName": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Import a STEP/.stp (or other native-importable) file into a NEW Fusion design via the native import API. The open-electronics hints redirect .step here. (Was implemented but missing from this catalog until the verb suite's reverse-drift check caught it, 2026-08-14.)",
"timeoutSeconds": 300
},
{
"example": {
"worldSpace": true
},
"input": {
"occurrence": "optional str (substring filter on occurrence name, worldSpace only)",
"worldSpace": "optional bool (resolve through occurrence transforms; default false = root component only)"
},
"longRunning": false,
"name": "fusion_inspect_bodies",
"output": {
"bodies": "[{name,owner,bbox:{x,y,z},sizeMm,volumeMm3,areaMm2,faceCount,cylindricalFaceCount,appearance,material,isVisible}]",
"bodyCount": "int",
"documentName": "str",
"success": "bool",
"units": "str (mm)"
},
"statusVerb": "fusion_get_app_state",
"summary": "GEOMETRY READ-BACK: what actually got built, in MILLIMETRES. Per body: bbox, sizeMm, volumeMm3, areaMm2, faceCount, cylindricalFaceCount, appearance, material, isVisible. Use this to VERIFY your own modelling - a body at the wrong Z (a double-applied offset, a part buried inside another) renders perfectly and is INVISIBLE in a screenshot, and this work is often matte-black parts on a dark canvas where pixels are a weak check. cylindricalFaceCount is the cheap way to confirm holes were actually cut: a symmetric cut that reaches nothing fails SILENTLY with no exception. Pass worldSpace:true to resolve bodies through their occurrence transforms (assembly placement); optionally filter with occurrence. Fusion's API is centimetres - this converts for you.",
"timeoutSeconds": 130
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_install_fusion",
"output": {
"alreadyInstalled": "bool?",
"installing": "bool",
"mode": "globalinstall|per-user",
"statusVerb": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Install Fusion 360 FOR the user - downloads Autodesk's official Client Downloader and streams the free trial silently, with NO shell_execute and NO ab approval gate (runs inside the trusted bridge). Elevation-aware: --globalinstall when admin, PER-USER otherwise (a non-elevated globalinstall dies silently on UAC - learned live). Returns promptly; poll fusion_readiness (reports installing:true) until installed:true, then fusion_start. Declared as detect.installVerb so ab's bridge_readiness recommends it.",
"timeoutSeconds": 90
},
{
"example": {
"libraryName": "MyLib",
"zipPath": "C:/Temp/MyLib.zip"
},
"input": {
"capture": "optional bool (default true: bind + prove; false: place only)",
"lbrPath": "str (staged .lbr, STEP models beside it)",
"libraryName": "optional str (default: file stem)",
"zipPath": "str (staged bundle zip on THIS machine) - or"
},
"longRunning": true,
"name": "fusion_install_library_bundle",
"output": {
"fusion": "{installed, running, addinReady, status, message}",
"installed": "bool",
"libraryPath": "str",
"partMetadata": "{ok, summary, warnings[]}",
"partsToBind": "int",
"partsTotal": "int",
"runId": "str",
"statusVerb": "fusion_prove_result",
"unbound": "[{package, why}]"
},
"statusVerb": "fusion_prove_result",
"summary": "COMPOSITE, the Fusion twin of kicad_install_library_bundle (#68): ONE call takes a staged Cloud Library bundle (zip of <Lib>.lbr + <Part>.step models, or a bare lbrPath with STEPs beside it), unpacks it safely, places it under ~/Documents/Adom Libraries/<name>/, pairs EVERY deviceset with its STEP by name (deviceset, package, normalised, prefix; a one-part library pairs its single model regardless), lints part numbers (partMetadata: MPN, manufacturer, Mouser/DigiKey/LCSC - reported, never blocking), pre-flights Fusion state (fusion{status}), and starts the same bind -> prove chain fusion_create_library runs. ASYNC BY CONTRACT: returns IMMEDIATELY with runId + statusVerb because a STEP bind is 3-15 minutes and cannot fit a relay window; poll fusion_prove_result (measured percent, four streamed proof frames per part, provedParts[], and an addin_restart_required payload the CALLER turns into the ask). PARTIAL SHIPS: a deviceset with no model is a NAMED skip in unbound[], the rest still bind; partsBound < partsTotal is the signal. Each part is minted on its own single-deviceset library (the Package3D generator loads the FIRST package of the open library, so a merged library would put every chip on part one's footprint), with the STEP placed exactly as published (orient:false, origin trusted), then all urns are bound into the merged library, and after prove the bound library is SAVED TO THE CLOUD under <project>/Adom Libraries so it appears in Fusion's Library Manager (cloudLibrary{saved, fileId, duplicatesBefore} in fusion_prove_result). Per-part scaffolding is deleted; the user is left with one library plus its per-package f3d folder. capture:false only places the files and returns. This is the one contract the wiki CLI (`library install --format fusion`) and the Export button both read; the recipe has one owner.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"probeMainThread": "optional bool (default true)"
},
"longRunning": false,
"name": "fusion_interactive",
"output": {
"activeJobs": "bool|null",
"addinBusy": "bool",
"addinUp": "bool",
"interactive": "bool",
"mainThreadMs": "int|null"
},
"statusVerb": null,
"summary": "Is Fusion taking input RIGHT NOW? Reads the add-in's busy flag (a long bridge command in flight), Fusion's own hasActiveJobs, and the main thread's latency on a trivial script (probeMainThread:false skips that and costs nothing). interactive:true means drive it; false means a load, a cloud open, or a bind is still running. The guided tour's narrator polls this every 1.5s and stamps fusion-busy / fusion-interactive transitions into the tour record, so a recording can be cut or sped up on them.",
"timeoutSeconds": 20
},
{
"example": {},
"input": {
"skipCleanClose": "optional bool"
},
"longRunning": false,
"name": "fusion_kill",
"output": {
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Force-KILL Fusion 360 (taskkill /F) - the desperate path for when fusion_stop cannot close it (stuck modal / wedged process). Closes docs cleanly first when reachable.",
"timeoutSeconds": 30
},
{
"example": {
"tab": "private"
},
"input": {
"tab": "optional str hub|public|private (default private)"
},
"longRunning": true,
"name": "fusion_library_manager",
"output": {
"hwnd": "int",
"libraries": "[str] (usually empty - see pitfall)",
"success": "bool",
"tab": "str",
"tableReadable": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Open Fusion's Library Manager and switch to one of its three tabs. Hub Libraries = libraries saved in the Fusion hub (what our bind chain produces, and what Autodesk recommends for sharing). Private Libraries = library.io managed libraries in folders THIS account belongs to. Public Libraries = library.io's public catalogue. PITFALL: the library TABLE is CEF-drawn and exposes NOTHING to UIA, so libraries[] is normally empty and that is not a failure - screenshot the returned hwnd to read the rows.",
"timeoutSeconds": 240
},
{
"example": {
"libraryPath": "C:/tmp/TJA1050.lbr"
},
"input": {
"libraryPath": "required str (also accepts lbrPath/filePath/path)"
},
"longRunning": true,
"name": "fusion_library_parts",
"output": {
"devicesets": "[{name, description, variants:[{fullName, device, technology, package, attributes, missing}]}]",
"metadataOk": "bool",
"success": "bool",
"totals": "{devicesets, variants, withMpn, withDistributor}",
"warnings": "[]"
},
"statusVerb": null,
"summary": "Every ORDERABLE variant in a .lbr with its part numbers - offline, no Fusion needed. For an EE this is the point of the library: two variants can share ONE symbol, ONE footprint and ONE 3D body and still be different products (an AEC-Q100 automotive part vs the baseline one), and that difference lives ENTIRELY in the metadata. EAGLE spells the orderable identity as deviceset + device + technology: <device> carries the PACKAGE variant, <technology> carries the GRADE/temperature variant, and attributes hang off <technology>. Reports per-variant MPN / MANUFACTURER / MOUSER_PN / DIGIKEY_PN / LCSC_PN (the exact names this bridge's own BOM export reads), plus warnings when variants are indistinguishable, share an MPN, or a deviceset has no description. These warnings never block the library from opening - they say whether an EE could actually order from it.",
"timeoutSeconds": 15
},
{
"example": {
"projectName": "Main"
},
"input": {
"folderPath": "optional str",
"projectName": "optional str (defaults to active project)"
},
"longRunning": true,
"name": "fusion_list_cloud_files",
"output": {
"files": "list",
"success": "bool"
},
"statusVerb": null,
"summary": "List files/folders in a cloud project (optionally a subfolder).",
"timeoutSeconds": 120
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_list_cloud_projects",
"output": {
"projects": "list",
"success": "bool"
},
"statusVerb": null,
"summary": "List the cloud PROJECTS visible to the signed-in Fusion session (hub walk - slow on big teams; prefer fusion_aps_search for finding files).",
"timeoutSeconds": 120
},
{
"example": {
"filter": "Electron"
},
"input": {
"filter": "optional str (substring, case-insensitive; default \"Electron\")"
},
"longRunning": false,
"name": "fusion_list_text_commands",
"output": {
"commands": "[str] (first 50 matches)",
"success": "bool",
"total": "int"
},
"statusVerb": null,
"summary": "List Fusion's internal TEXT COMMANDS (TextCommands.List) whose name contains filter, case-insensitive; the discovery tool for fusion_execute_text_command. Returns the first 50 matches plus the total count. Works best with an electronics editor active (the Electron.* family is what the default filter finds).",
"timeoutSeconds": 30
},
{
"example": {
"action": "frames",
"since": 0
},
"input": {
"action": "start|stop|status|frames",
"intervalSec": "optional float (default 1.0)",
"maxSec": "optional float (default 600)",
"since": "frames only: return ticks newer than this"
},
"longRunning": true,
"name": "fusion_live_feed",
"output": {
"frames": "[{tick, kind:main|popup, path, title, at}]",
"running": "bool",
"success": "bool",
"tick": "int"
},
"statusVerb": null,
"summary": "A ~1 fps look INTO Fusion while the bridge drives it, kept as a BOX-SIDE ring buffer (~10 min). Each tick records the Fusion main window (kind:main - the video) and every owned popup over it (kind:popup - dialogs, Browser/tool panels, the Adom banner; Fusion draws these as separate windows a main capture omits), each a path on this machine tied to its tick. Drain from the container with {action:frames, since:<tick>}, read_file each path, and publish where a human looks - tools/live_feed_drain.py does exactly that into shotlog. Proof frames are NOT here: fusion_prove_result evidence[] carries kind:proof with step labels, so the three kinds are distinguishable at the source. Exists so a human can see open tabs and dialogs during boot or a restart instead of guessing.",
"timeoutSeconds": 15
},
{
"example": {
"captureLabel": "R_4k7",
"lbrPath": "C:/tmp/newlib/R_4k7.lbr",
"modelPath": "C:/tmp/newlib/R_4k7.step"
},
"input": {
"captureLabel": "optional str (capture before/after)",
"fileName": "optional str",
"folderId": "optional str (default upload folder)",
"lbrPath": "required str (.lbr WINDOWS path; its FIRST package's footprint is loaded)",
"modelPath": "required str (.step WINDOWS path)",
"orient": "optional bool (default true). false = import exactly as authored: NO bounding-box reorientation and NO pin-1 rotation (1.10.8)",
"placement": "optional {translation:[x,y,z] mm, rotation:[rx,ry,rz] deg (about X, then Y, then Z, extrinsic, about the origin), scale:1} from the manufacturer's authored transform. Bypasses every heuristic; the reply returns the applied 4x4 matrix (mm), verification (verified|mismatch), source {path, sha256, bytes} and warnings. Non-finite values, wrong shapes and any scale other than 1 are refused before Fusion is touched (invalid_placement / unsupported_scale)",
"projectId": "optional str (default MAIN-project)"
},
"longRunning": true,
"name": "fusion_make_3d_package",
"output": {
"after": "str|null",
"before": "str|null",
"dims_mm": "[x,y,z]",
"f3d": "str",
"success": "bool",
"wip_urn": "str"
},
"statusVerb": "fusion_get_app_state",
"summary": "Create a RENDERING component 3D package (FOOTPRINT + chip, aligned) for ONE part, fully programmatically with ZERO GUI dialogs. Opens the .lbr, runs Electron.Create3DPackage to load the package's footprint into a generator doc, imports the STEP onto it, orients it flat, saveAs an .f3d (skips the FINISH Save dialog + the two unbeatable 'Fusion360' CEF modals), uploads the f3d via APS, and returns an fs.file:vf wip_urn to hand-write into the library's <packages3d>. projectId/folderId default to the MAIN-project upload folder. Pass captureLabel to also get a BEFORE (footprint) + AFTER (chip placed) screenshot. PITFALL: a RAW STEP upload binds but renders NOTHING ('Thumbnail download failed') - this verb makes an f3d, which renders. Prefer fusion_build_library_3d for many parts.",
"timeoutSeconds": 200
},
{
"example": {
"devicesets": [
"VL53L5CX",
"VL53L7CX",
"VL53L8CX"
],
"libraryPath": "C:/Users/me/Downloads/Adom_ToF.lbr"
},
"input": {
"devicesets": "optional [str] (default: every deviceset in the library)",
"libraryPath": "required str (.lbr on the Fusion machine; a component page's .lbr or a merged bundle library)",
"name": "optional str document name (default <library>-showcase)",
"silkLabels": "optional bool (default true): the part name on layer 21 under each footprint"
},
"longRunning": true,
"name": "fusion_make_showcase_project",
"output": {
"brdPath": "str",
"documentName": "str",
"parts": "[{ref, deviceset, package, symbol}]",
"partsPlaced": "int (read back from the board)",
"schPath": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Put a library's parts on a NEW schematic and board to SHOW THEM OFF: every deviceset in the .lbr (or the ones in devicesets[]) placed in a row on a fresh sheet and a fresh board, no nets, with the library's bound 3D urns carried across so the 3D PCB shows the real bodies. Generated as EAGLE source on the box and opened dialog-free (Document.newDesignFromLocal), so nothing touches the user's screen. This is THE verb for 'make a board with these new parts on it'; fusion_make_test_project is the one-part circuit variant. After it: fusion_show_2d_board / fusion_show_3d_board {capture:true}, fusion_schematic {action:\"show\"}, fusion_save_to_cloud. The name of each part is written on the top silkscreen under its footprint (silkLabels:false turns it off); fusion_make_test_project does the same.",
"timeoutSeconds": 300
},
{
"example": {
"libraryPath": "C:/Temp/IN-S42ATR.lbr"
},
"input": {
"device": "optional str: the DEVICE (package variant) to place, e.g. \"-HV\" (default: the deviceset's first device)",
"deviceset": "optional str (defaults to the library's first deviceset)",
"libraryPath": "required str (WINDOWS path .lbr; stage from container first)"
},
"longRunning": true,
"name": "fusion_make_test_project",
"output": {
"brdPath": "str",
"circuit": "str",
"schPath": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Create a NEW electronics test project FROM SCRATCH around a library part - the Web Control demo's PROJECT button, and the answer to 'a customer only has a component page'. Generates a minimal test circuit server-side (the part + a generated 330R series resistor with VCC/GND stubs on a small board) as real EAGLE .sch/.brd, then imports the pair as a new electronics design. NO cloud, NO sign-in, no pre-existing content. After it, fusion_show_schematic / fusion_show_2d_board / fusion_show_3d_board all work on the result. Wiring uses the deviceset's own connects (first two pins), so 2-terminal parts get a real circuit and big ICs get a structurally-valid integration proof.",
"timeoutSeconds": 300
},
{
"example": {},
"input": {
"description": "optional str",
"name": "optional str (defaults to the library's own name)"
},
"longRunning": true,
"name": "fusion_managed_library_create",
"output": {
"alerts": "[...]",
"library": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Create a NEW managed library on library.io FROM the library in front (which must already be saved in a Fusion Hub). Drives MANAGE > LIBRARY.IO > Push, then completes Fusion's Create Managed Library dialog. PITFALL: a managed library created under one Autodesk account is NOT visible to another account until its managed FOLDER is shared on library.io - proven live, so do not assume hub membership shares it.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {
"name": "optional str (exact library name from the picker; omit to list read-only)",
"onUpdatePrompt": "optional str cancel|merge|replace (default cancel; replace OVERWRITES the local library)"
},
"longRunning": true,
"name": "fusion_managed_library_link",
"output": {
"alerts": "[...]",
"linkedTo": "str?",
"listedOnly": "bool?",
"managedLibraries": "[{name,type,version,managedFolder,description}]",
"success": "bool",
"updatePrompt": "obj?"
},
"statusVerb": "fusion_get_app_state",
"summary": "Link the library IN FRONT to an existing managed library on library.io. With no name, opens Fusion's Select Managed Library picker, returns its rows as records (name/type/version/managedFolder/description) and CANCELS - a safe read-only listing of what this Autodesk account can reach. With name, selects that row and confirms. SAFETY: after linking, Fusion offers to force-update your library FROM the managed one; 'Replace Local Library' would destroy your parts, so this verb answers CANCEL by default - pass onUpdatePrompt to choose deliberately. A managed library owned by ANOTHER Autodesk account does NOT appear until its managed FOLDER is shared with this account on library.io; being in the same Fusion hub is not enough.",
"timeoutSeconds": 180
},
{
"example": {},
"input": {
"onUpdatePrompt": "optional str merge|replace|cancel (default merge)"
},
"longRunning": true,
"name": "fusion_managed_library_pull",
"output": {
"alerts": "[...]",
"library": "str",
"success": "bool",
"upToDate": "bool",
"updatePrompt": "obj?"
},
"statusVerb": "fusion_get_app_state",
"summary": "Pull the newest version FROM library.io into the linked library in front. A pull ends in ONE of two CEF dialogs and BOTH block the add-in until answered: the force-update prompt when content differs (answered MERGE by default, since pull is an explicit request for the managed content - pass onUpdatePrompt:'replace' to overwrite local parts entirely, or 'cancel' to back out), or 'Up to Date' when already current. If neither appears, nothing was pulled and this reports failure rather than a false pass - Fusion greys Pull out on a library that was never linked.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {
"onConfirm": "optional str create|cancel (default create)"
},
"longRunning": true,
"name": "fusion_managed_library_push",
"output": {
"alerts": "[...]",
"confirmed": "obj",
"library": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Push a NEW VERSION of the library in front up to its linked managed library on library.io. Clicking the menu item alone does NOT push: Fusion raises a CEF 'Create New Version' confirmation and THAT is what creates the version, so this verb completes it and fails with confirm_missing rather than reporting a false pass. On a library that is not linked yet, Fusion offers Create Managed Library instead and this reports not_linked_yet - use fusion_managed_library_create. NOTE: Library Manager keeps showing the IMPORTED version number after a push, so the row gains an update-available badge instead of incrementing.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_managed_library_unlink",
"output": {
"alerts": "[...]",
"library": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Unlink the library in front from its managed library on library.io. Fusion greys this out on a library that was never linked, so a silent no-op there is expected.",
"timeoutSeconds": 180
},
{
"example": {
"arguments": {
"queryType": "activeCommand"
},
"tool": "fusion_mcp_read"
},
"input": {
"arguments": "optional obj (per that tool's inputSchema)",
"timeout": "optional int seconds, default 120",
"tool": "required str (from fusion_mcp_tools)"
},
"longRunning": true,
"name": "fusion_mcp_call",
"output": {
"result": "obj",
"tool": "str"
},
"statusVerb": "fusion_mcp_status",
"summary": "Call any tool on Autodesk's Fusion MCP server (fusion_mcp_read, fusion_mcp_update, fusion_mcp_execute, fusion_mcp_electronics_read). The bridge handles the MCP streamable-HTTP handshake for you (initialize -> MCP-Session-Id -> notifications/initialized) and re-establishes a dropped session automatically. MCP acts on the ACTIVE Fusion document, so open one first. PREFER a native fusion_* verb when one exists - they are tested here and return richer hints - and reach for MCP for Autodesk's text-to-CAD surface.",
"timeoutSeconds": 150
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_mcp_enable",
"output": {
"alreadyOn": "bool",
"enabled": "bool",
"serverInfo": "obj",
"steps": "list"
},
"statusVerb": "fusion_mcp_status",
"summary": "Turn Autodesk's Fusion MCP server ON by driving Fusion's Preferences dialog for the user. Autodesk exposes NO API for this toggle, so the UI is the only route: this opens Preferences (Commands.Start PreferencesCommand), expands General, selects API, ticks 'Fusion MCP Server (runs locally on this device)', then clicks Apply and OK. Needs Fusion running; briefly uses the foreground and announces why with an on-screen caption. NEVER ask the user to do this by hand first - do it for them, then tell them it is handled. Note the setting is DISCARDED if Fusion is killed or restarted before Apply is clicked.",
"timeoutSeconds": 180
},
{
"example": {},
"input": {
"uri": "optional str (omit to list)"
},
"longRunning": false,
"name": "fusion_mcp_resources",
"output": {
"count": "int",
"resources": "[str]",
"result": "obj"
},
"statusVerb": "fusion_mcp_status",
"summary": "List Autodesk MCP resources, or read one by uri. These are mostly the Electronics entity schemas (resource://mcp.electronics_schema_*) that describe what fusion_mcp_electronics_read can return.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_mcp_status",
"output": {
"enabled": "bool",
"serverInfo": "obj",
"toolCount": "int",
"tools": "[{name,description}]"
},
"statusVerb": "fusion_mcp_status",
"summary": "Is Autodesk's Fusion MCP server up, and what does it expose? Autodesk + Anthropic ship a LOCAL MCP server at http://127.0.0.1:27182/mcp exposing Fusion's own text-to-CAD surface (read geometry, execute/update features, read Electronics design data). It binds LOOPBACK on the user's machine and was built for Claude Desktop running there, so a CLOUD AI cannot reach it at all - this bridge runs on that machine and proxies it for you. Returns enabled, serverInfo and the live tool list. OFF by default: if it reports enabled:false, call fusion_mcp_enable and the bridge turns it on for the user.",
"timeoutSeconds": 45
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_mcp_tools",
"output": {
"count": "int",
"tools": "list"
},
"statusVerb": "fusion_mcp_status",
"summary": "Full tool list from Autodesk's Fusion MCP server INCLUDING input schemas, so you can construct a valid fusion_mcp_call. These are Autodesk's tools, not this bridge's.",
"timeoutSeconds": 45
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_mech_capabilities",
"output": {
"idempotency": "object",
"operations": {
"assembly_properties": {
"description": "High-accuracy physical properties of whole root assembly (default) or an exact Component/Occurrence/BRepBody. Returns mass kg, volume mm3, area mm2, center of mass mm, mean density kg/mm3 and definition/instance coordinate scope.",
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"bom": {
"description": "Structured component-definition and instance BOM; quantities by actual identity, root bodies plus nested children; purchased metadata collapses subtrees unless exploded. Physical mass includes all unsuppressed bodies exactly once per instance. Includes exact current active configuration provenance; incomplete configuration scope refuses. Visibility does not remove quantity.",
"properties": {
"explodePurchased": {
"type": "boolean"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"bom_export": {
"description": "Export flat grouped purchasing rows or structured parent/path/depth instance rows and supplier provenance to CSV with exclusive/atomic publication. This external effect is separate from model transactions. Both CSV modes include document/revision and current active configuration table/row provenance.",
"properties": {
"explodePurchased": {
"type": "boolean"
},
"filename": {
"type": "string"
},
"mode": {
"enum": [
"flat",
"structured"
]
},
"overwrite": {
"type": "boolean"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"filename"
],
"type": "object"
},
"cad_import": {
"description": "Import a pre-downloaded local STEP/SAT into a new wrapper component in Hybrid design. Validate optional expected SHA-256, record actual source/hash/supplier metadata, preserve camera, measure model recovery. Does not fetch URLs or create cloud documents. Returns a representative root-context occurrence and all affectedOccurrences when the parent definition is reused.",
"properties": {
"asPurchased": {
"type": "boolean"
},
"filename": {
"type": "string"
},
"name": {
"type": "string"
},
"parent": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"provenance": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"supplier": {
"type": "string"
},
"supplierPartNumber": {
"type": "string"
}
},
"required": [
"supplier",
"supplierPartNumber",
"sourceUrl"
],
"type": "object"
},
"sha256": {
"type": "string"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"filename",
"provenance"
],
"type": "object"
},
"component_create": {
"description": "Create a native internal component and its first occurrence in a Hybrid design. parent is a component definition; edits to it affect every instance. Returns a representative root-context occurrence and all affectedOccurrences when the parent definition is reused.",
"properties": {
"metadata": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"asPurchased": {
"type": "boolean"
},
"description": {
"type": "string"
},
"excludeFromBom": {
"type": "boolean"
},
"name": {
"type": "string"
},
"partNumber": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"supplier": {
"type": "string"
},
"supplierPartNumber": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": {
"type": "string"
},
"parent": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"name"
],
"type": "object"
},
"component_metadata": {
"description": "Update component-definition name/part number/description and persistent supplier or BOM attributes. Shared occurrences all see this metadata.",
"properties": {
"changes": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"asPurchased": {
"type": "boolean"
},
"description": {
"type": "string"
},
"excludeFromBom": {
"type": "boolean"
},
"name": {
"type": "string"
},
"partNumber": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"supplier": {
"type": "string"
},
"supplierPartNumber": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"component": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"changes"
],
"type": "object"
},
"configuration_inspect": {
"description": "Read the loaded Design configuration graph without activation or recompute: ordinary rows, the separate native reserved test row, all supported typed cells including inactive/test cells, exact controlled-source links and current ordinary row. Unreadable fields and unknown/theme/hierarchical/inserted scopes remain explicit incomplete diagnostics. Configuration lifecycle and configured-design model mutations remain disabled pending native recovery/archive gates.",
"properties": {},
"required": [
"op",
"target"
],
"type": "object"
},
"construction_axis": {
"description": "Create a parametric axis from native references (edge/circular face/two intersecting planes/two distinct points). Root-space external geometry requires exact occurrence context. For cross-component geometry into a non-root target component, creationOccurrence must identify a root-context instance of that target. Returns component-space native axis geometry/health. No direct-only infinite-line or preview snap APIs.",
"properties": {
"component": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"creationOccurrence": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entities": {
"items": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"type": {
"enum": [
"edge",
"circular_face",
"two_planes",
"two_points"
]
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"type",
"entities"
],
"type": "object"
},
"entity_delete": {
"description": "Delete sketch geometry or independently deletable timeline features. Model transaction and semantic recovery cover downstream failures; document and external file deletion are excluded.",
"properties": {
"entity": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"entity"
],
"type": "object"
},
"exploded_preview_create": {
"description": "Create finite copied solid-BRep presentation graphics in the exact active blank unsaved Design proven by a committed current-session new_design result. Regenerates the guarded source plan; leaves source active. Exclusive session lease, no source moves/visibility writes, no model transaction, automatic document close, render or capture. Live capability and native backend qualification are separate from durable operation receipts.",
"properties": {
"creationOperationId": {
"type": "string"
},
"expectedPlanId": {
"type": "string"
},
"planner": {
"additionalProperties": false,
"properties": {
"playback": {
"enum": [
"explode",
"assemble"
],
"type": "string"
},
"sampleTimes": {
"items": {
"maximum": 3600,
"minimum": 0,
"type": "number"
},
"maxItems": 62,
"type": "array"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"exclusiveMinimum": 0,
"maximum": 3600,
"type": "number"
},
"instruction": {
"type": "string"
},
"moves": {
"items": {
"additionalProperties": false,
"properties": {
"direction": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"distance": {
"exclusiveMinimum": 0,
"maximum": 1000000.0,
"type": "number"
},
"frame": {
"enum": [
"world",
"parent",
"local"
],
"type": "string"
},
"occurrence": {
"description": "Exact guarded occurrence reference from inspect; every repeated/nested instance is distinct.",
"type": "object"
}
},
"required": [
"occurrence",
"direction",
"distance",
"frame"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"durationSeconds",
"moves"
],
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"type": "array"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
}
},
"required": [
"unit",
"steps"
],
"type": "object"
},
"sessionId": {
"type": "string"
},
"sourceTarget": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sourceTarget",
"creationOperationId",
"expectedPlanId",
"planner"
],
"type": "object"
},
"exploded_preview_dispose": {
"description": "Delete only the exact retained graphics tree and leave the blank document open for caller. Supports a narrowly proven cleanup after unresolved terminal storage without rewriting that history; no global Undo or close. Requires the current controller capability, presentation target, generation and a durable operation ID. Old-session native resources are never rebound.",
"properties": {
"expectedGeneration": {
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"previewId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"previewId",
"expectedGeneration"
],
"type": "object"
},
"exploded_preview_inspect": {
"description": "Main-thread live preview ownership/geometry/history observation. Cached operation receipts do not establish current graphics liveness. Old-session history remains separately readable through mech_operation_status; no native reference adoption or lifecycle repair is provided here.",
"properties": {
"previewId": {
"type": "string"
},
"sessionId": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"previewId"
],
"type": "object"
},
"exploded_preview_sample": {
"description": "Apply one server-stored absolute sample to exact-owned graphics; preserve active document. Source must remain unchanged. Requires the current controller capability, presentation target, generation and a durable operation ID. Old-session native resources are never rebound.",
"properties": {
"expectedGeneration": {
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"previewId": {
"type": "string"
},
"sampleIndex": {
"maximum": 63,
"minimum": 0,
"type": "integer"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"previewId",
"expectedGeneration",
"sampleIndex"
],
"type": "object"
},
"exploded_preview_show": {
"description": "Explicitly activate the exact-owned presentation in Fusion; refuse an intervening foreign active document. No OS foreground, camera change or capture. Requires the current controller capability, presentation target, generation and a durable operation ID. Old-session native resources are never rebound.",
"properties": {
"expectedGeneration": {
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"previewId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"previewId",
"expectedGeneration"
],
"type": "object"
},
"exploded_view_plan": {
"description": "Read-only source-bound exploded assembly plan. Normalized translation directions in immutable home world/parent/local axes; simultaneous moves within ordered steps. Descendants inherit ancestor translations once, plus own moves. Bounded deterministic sample matrices and exact home reverse endpoint. No native moves, graphics, BOM quantity changes, render/video or storyboard creation. Complete configuration identity required.",
"properties": {
"playback": {
"enum": [
"explode",
"assemble"
],
"type": "string"
},
"sampleTimes": {
"items": {
"maximum": 3600,
"minimum": 0,
"type": "number"
},
"maxItems": 62,
"type": "array"
},
"sessionId": {
"type": "string"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"exclusiveMinimum": 0,
"maximum": 3600,
"type": "number"
},
"instruction": {
"type": "string"
},
"moves": {
"items": {
"additionalProperties": false,
"properties": {
"direction": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"distance": {
"exclusiveMinimum": 0,
"maximum": 1000000.0,
"type": "number"
},
"frame": {
"enum": [
"world",
"parent",
"local"
],
"type": "string"
},
"occurrence": {
"description": "Exact guarded occurrence reference from inspect; every repeated/nested instance is distinct.",
"type": "object"
}
},
"required": [
"occurrence",
"direction",
"distance",
"frame"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"durationSeconds",
"moves"
],
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"type": "array"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
}
},
"required": [
"op",
"sessionId",
"target",
"unit",
"steps"
],
"type": "object"
},
"export": {
"description": "Export entire design using runtime-checked API. Preflight and unique same-filesystem staging preserve the destination on failure; publish only nonempty verified output. Availability differs by Fusion build. STL numeric coordinates use mm.",
"properties": {
"format": {
"default": "step",
"enum": [
"step",
"stl",
"3mf",
"f3d",
"iges",
"sat",
"smt",
"usdz",
"fbx",
"skp"
]
},
"outputPath": {
"type": "string"
},
"overwrite": {
"default": false,
"type": "boolean"
},
"refinement": {
"default": "medium",
"enum": [
"low",
"medium",
"high"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"outputPath"
],
"type": "object"
},
"feature_create": {
"description": "Create a typed native solid feature. All length quantities are mm (or expressions), angles deg. Cut/intersect require explicit participant bodies. Join needs a single existing component body; combine selects multiple bodies explicitly. Feature availability is runtime-checked; missing APIs fail before commit.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"direction": {
"enum": [
"positive",
"negative",
"symmetric"
]
},
"distance": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"taper": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"extrude"
]
}
},
"required": [
"type",
"profiles",
"distance"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"revolve"
]
}
},
"required": [
"type",
"profiles",
"axis",
"angle"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"edges": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"radius": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"fillet"
]
}
},
"required": [
"type",
"edges",
"radius"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"distance": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"edges": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"chamfer"
]
}
},
"required": [
"type",
"edges",
"distance"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"faces": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"thickness": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"type": {
"enum": [
"shell"
]
}
},
"required": [
"type",
"faces",
"thickness"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"depth": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"diameter": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"points": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"hole"
]
}
},
"required": [
"type",
"points",
"diameter",
"depth",
"bodies"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"loft"
]
}
},
"required": [
"type",
"profiles"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"path": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"sweep"
]
}
},
"required": [
"type",
"profiles",
"path"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"body": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keepTools": {
"type": "boolean"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"tools": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"type": {
"enum": [
"combine"
]
}
},
"required": [
"type",
"body",
"tools",
"operation"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"extend": {
"type": "boolean"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"split"
]
}
},
"required": [
"type",
"bodies",
"plane"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"origin": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"translation": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"move"
]
}
},
"required": [
"type",
"bodies"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"mirror"
]
}
},
"required": [
"type",
"bodies",
"plane"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"axis2": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"count": {
"maximum": 1000,
"minimum": 2,
"type": "integer"
},
"count2": {
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"spacing": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"spacing2": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"rectangular_pattern"
]
}
},
"required": [
"type",
"bodies",
"axis",
"count",
"spacing"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"count": {
"maximum": 1000,
"minimum": 2,
"type": "integer"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"circular_pattern"
]
}
},
"required": [
"type",
"bodies",
"axis",
"count"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"faces": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"draft"
]
}
},
"required": [
"type",
"faces",
"plane",
"angle"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"designation": {
"type": "string"
},
"faces": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"internal": {
"type": "boolean"
},
"modeled": {
"type": "boolean"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"threadClass": {
"type": "string"
},
"threadType": {
"type": "string"
},
"type": {
"enum": [
"thread"
]
}
},
"required": [
"type",
"faces",
"internal",
"threadType",
"designation",
"threadClass"
],
"type": "object"
}
],
"properties": {
"angle": {},
"axis": {},
"axis2": {},
"bodies": {},
"body": {},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"count": {},
"count2": {},
"depth": {},
"designation": {},
"diameter": {},
"direction": {},
"distance": {},
"edges": {},
"extend": {},
"faces": {},
"internal": {},
"keepTools": {},
"modeled": {},
"name": {
"type": "string"
},
"operation": {},
"origin": {},
"path": {},
"plane": {},
"points": {},
"profiles": {},
"radius": {},
"spacing": {},
"spacing2": {},
"tangentChain": {},
"taper": {},
"thickness": {},
"threadClass": {},
"threadType": {},
"tools": {},
"translation": {},
"type": {
"enum": [
"extrude",
"revolve",
"fillet",
"chamfer",
"shell",
"hole",
"loft",
"sweep",
"combine",
"split",
"move",
"mirror",
"rectangular_pattern",
"circular_pattern",
"draft",
"thread"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type"
],
"type": "object"
},
"feature_edit": {
"description": "Rename/suppress a feature or change expressions of model parameters whose createdBy is that exact feature; read health and abort on downstream errors.",
"properties": {
"feature": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"parameters": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"suppressed": {
"type": "boolean"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"feature"
],
"type": "object"
},
"geometry_query": {
"description": "Complete body-scoped topology query, no arbitrary first-match selection. selection one (default) refuses zero/multiple matches; many may return empty. Geometry types are exact native types; size ranges inclusive in mm/mm2, near is minimum distance in the explicit frame; direction is outward planar face normal or linear edge tangent. Returned refs retain instance context even for component-space filters. Exceeding maxResults fails rather than truncating.",
"properties": {
"body": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"filters": {
"additionalProperties": false,
"properties": {
"area": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"max": {
"minimum": 0,
"type": "number"
},
"min": {
"minimum": 0,
"type": "number"
}
},
"required": [],
"type": "object"
},
"direction": {
"additionalProperties": false,
"properties": {
"orientation": {
"enum": [
"same",
"parallel"
]
},
"tolerance": {
"maximum": 90,
"minimum": 0,
"type": "number"
},
"vector": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"vector"
],
"type": "object"
},
"length": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"max": {
"minimum": 0,
"type": "number"
},
"min": {
"minimum": 0,
"type": "number"
}
},
"required": [],
"type": "object"
},
"near": {
"additionalProperties": false,
"properties": {
"point": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"tolerance": {
"minimum": 0,
"type": "number"
}
},
"required": [
"point",
"tolerance"
],
"type": "object"
},
"radius": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"max": {
"minimum": 0,
"type": "number"
},
"min": {
"minimum": 0,
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": {
"enum": [
"Plane",
"Cylinder",
"Cone",
"Sphere",
"Torus",
"NurbsSurface",
"Line3D",
"Arc3D",
"Circle3D",
"Ellipse3D",
"EllipticalArc3D",
"NurbsCurve3D",
"Point3D",
"degenerate"
]
}
},
"required": [],
"type": "object"
},
"kind": {
"enum": [
"faces",
"edges",
"vertices"
]
},
"maxResults": {
"maximum": 1024,
"minimum": 1,
"type": "integer"
},
"selection": {
"enum": [
"one",
"many"
]
},
"space": {
"enum": [
"root",
"component"
]
}
},
"required": [
"op",
"target",
"body",
"kind",
"space"
],
"type": "object"
},
"health": {
"description": "Read timeline warnings/errors. recompute:true also requires current target revision, sessionId and operationId.",
"properties": {
"recompute": {
"default": false,
"type": "boolean"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"inspect": {
"description": "Inspect the active Design without mutation. Returns target identity/revision, native component-space bodies and occurrence transforms, parameters and feature health.",
"properties": {},
"required": [
"op"
],
"type": "object"
},
"inspect_entity": {
"properties": {
"entity": {
"description": "Exact reference returned by inspect; resolves uniquely with document/revision/type/occurrence guards.",
"type": "object"
}
},
"required": [
"op",
"target",
"entity"
],
"type": "object"
},
"interference": {
"description": "Analyze root-context occurrences/body proxies; returns overlap volume mm3 or touching. Does not create interference bodies.",
"properties": {
"entities": {
"items": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 2,
"type": "array"
},
"includeTouching": {
"type": "boolean"
},
"volumeTolerance": {
"minimum": 0,
"type": "number"
}
},
"required": [
"op",
"target",
"entities"
],
"type": "object"
},
"joint_create": {
"description": "Create an as-built joint without moving occurrences. Non-rigid motion requires explicit joint geometry; x/y/z are joint-coordinate directions. Limits and drive values use mm/deg. Seven native motion types; ball uses joint Z pitch/X yaw; planar uses native primary slide direction reported on readback. Use regular_joint_create for geometry-solving placement.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"rigid"
]
}
},
"required": [
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"revolute"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"slider"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"cylindrical"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"pin_slot"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"planar"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"ball"
]
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"type",
"geometry"
],
"type": "object"
}
],
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"type": {
"enum": [
"rigid",
"revolute",
"slider",
"cylindrical",
"pin_slot",
"planar",
"ball"
]
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type",
"occurrenceOne",
"occurrenceTwo"
],
"type": "object"
},
"joint_delete": {
"description": "Delete one selected Joint or AsBuiltJoint with recovery verification.",
"properties": {
"joint": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"joint"
],
"type": "object"
},
"joint_edit": {
"description": "Edit joint name/suppression, enabled limits, rest and drive values; wrong motion type or out-of-limit values fail with recovery. For driven root joints, active motion links must preserve their settings and their partner motion must follow the native ratio; a coupling mismatch aborts.",
"properties": {
"joint": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"joint"
],
"type": "object"
},
"joint_origin_create": {
"description": "Create a native component-definition joint origin from guarded native geometry, with mm offsets/deg angle and optional straight axis references. Child occurrence origin references are exposed by inspect_entity(occurrence).",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"component": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"flipped": {
"type": "boolean"
},
"geometry": {
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"offsetX": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetY": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetZ": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"xAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"zAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"geometry"
],
"type": "object"
},
"joint_origin_delete": {
"description": "Delete a native joint origin; unhealthy downstream joints cause transaction rollback.",
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"origin"
],
"type": "object"
},
"joint_origin_edit": {
"description": "Edit a native joint origin definition; rolls before its timeline item and restores the original marker in finally. Recomputes and verifies attachment, axes, offsets, angle, name and flip.",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"flipped": {
"type": "boolean"
},
"geometry": {
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"offsetX": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetY": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetZ": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"xAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"zAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"origin"
],
"type": "object"
},
"material_assign": {
"description": "Assign a loaded library or document material to an exact native Component/BRepBody; verify material ID readback with model transaction recovery. Query assembly_properties for resulting mass.",
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"libraryId": {
"type": "string"
},
"materialId": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"entity",
"materialId"
],
"type": "object"
},
"material_list": {
"description": "List loaded material libraries and matching materials by stable library/material IDs. Omit libraryId for document materials.",
"properties": {
"libraryId": {
"type": "string"
},
"limit": {
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"query": {
"type": "string"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"mcmaster_discover": {
"description": "Discover Fusion native Insert McMaster-Carr command and requirements in the active design.",
"properties": {},
"required": [
"op"
],
"type": "object"
},
"mcmaster_open": {
"description": "Invoke Fusion native McMaster UI in the targeted Hybrid design. Interactive external operation: completion/insert/cancel stays with Fusion; inspect afterward. Idempotency records launch only.",
"properties": {},
"required": [
"op",
"sessionId",
"operationId",
"target"
],
"type": "object"
},
"measure": {
"description": "Native engineering minimum distance or angle in root assembly space. Non-root definition refs require an occurrence context. Distance needs2 entities; angle needs2 lines/planes or3 points (second apex). Returns mm/deg and native witness positions in root mm. witnessValidation identifies native points or native geometry directions used for valid parallel angles with degenerate native points; degenerate point angles and unavailable/inconsistent witnesses fail.",
"properties": {
"entities": {
"items": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"space": {
"enum": [
"root"
]
},
"type": {
"enum": [
"distance",
"angle"
]
}
},
"required": [
"op",
"target",
"type",
"space",
"entities"
],
"type": "object"
},
"motion_link_create": {
"description": "Create a native motion link between two root-owned joints, or two different motions of jointOne when jointTwo is omitted. Positive ratio magnitudes use mm for translation and deg for rotation; reversed selects opposite direction. Requires the November 2025+ API; no script fallback.",
"properties": {
"jointOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"jointTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"motionOne": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"motionTwo": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"reversed": {
"type": "boolean"
},
"valueOne": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"valueTwo": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"jointOne",
"motionOne",
"motionTwo",
"valueOne",
"valueTwo"
],
"type": "object"
},
"motion_link_delete": {
"description": "Delete a root-owned motion link under the same transaction/recovery contract.",
"properties": {
"link": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"link"
],
"type": "object"
},
"motion_link_edit": {
"description": "Edit a root-owned motion link ratio, degree-of-freedom pair, direction, name or suppression. Joint membership is immutable; recreate the link to change members. Verify exact joint identities, ratio, flags and health.",
"properties": {
"link": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"motionOne": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"motionTwo": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"reversed": {
"type": "boolean"
},
"suppressed": {
"type": "boolean"
},
"valueOne": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"valueTwo": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"link"
],
"type": "object"
},
"new_design": {
"description": "Create an unnamed unsaved parametric hybrid Design; name is retained as requestedName metadata to keep failure recovery free of save dialogs. Optional box dimensions in mm create a driving-parameter fixture. Never edits an existing document.",
"properties": {
"box": {
"additionalProperties": false,
"properties": {
"depth": {
"exclusiveMinimum": 0,
"type": "number"
},
"height": {
"exclusiveMinimum": 0,
"type": "number"
},
"width": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"width",
"height",
"depth"
],
"type": "object"
},
"name": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"operationId"
],
"type": "object"
},
"occurrence_delete": {
"description": "Delete one selected occurrence through the shared transaction executor.",
"properties": {
"occurrence": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"occurrence"
],
"type": "object"
},
"occurrence_insert": {
"description": "Insert another occurrence of an existing definition; independentCopy:true uses Paste New to create a separate definition. Nested placement is in parent component coordinates. Returns a representative root-context occurrence and all affectedOccurrences when the parent definition is reused.",
"properties": {
"component": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"independentCopy": {
"type": "boolean"
},
"parent": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"component"
],
"type": "object"
},
"occurrence_update": {
"description": "Set occurrence pose in its assembly context and capture position; explicit grounding/ungrounding. Grounded or constrained transforms fail with recovery.",
"properties": {
"grounded": {
"type": "boolean"
},
"groundedToParent": {
"type": "boolean"
},
"occurrence": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"occurrence"
],
"type": "object"
},
"parameter_batch": {
"description": "Atomic sequential create/set/delete parameter edits with one recompute+health gate; delete supports user parameters only. Any failure aborts all edits and reports semantic recovery.",
"properties": {
"changes": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"create"
]
},
"comment": {
"type": "string"
},
"expression": {
"type": "string"
},
"name": {
"type": "string"
},
"unit": {
"enum": [
"mm",
"deg",
"kg",
""
]
}
},
"required": [
"action",
"name",
"expression",
"unit"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"set"
]
},
"expression": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"action",
"name",
"expression"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"delete"
]
},
"name": {
"type": "string"
}
},
"required": [
"action",
"name"
],
"type": "object"
}
]
},
"maxItems": 128,
"minItems": 1,
"type": "array"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"changes"
],
"type": "object"
},
"parameter_create": {
"properties": {
"comment": {
"type": "string"
},
"expression": {
"type": "string"
},
"name": {
"type": "string"
},
"unit": {
"enum": [
"mm",
"deg",
"kg",
""
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"name",
"expression",
"unit"
],
"type": "object"
},
"parameter_set": {
"description": "Set an expression, recompute and inspect health. Failure restores old expression and reports a semantic recovery witness; not an atomic transaction.",
"properties": {
"expression": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"name",
"expression"
],
"type": "object"
},
"plane_create": {
"description": "Create offset plane (offset in mm) or angled plane around axis (angle in deg).",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"offset": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"offset"
]
}
},
"required": [
"type",
"offset"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"angle"
]
}
},
"required": [
"type",
"axis",
"angle"
],
"type": "object"
}
],
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"offset": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"type": {
"enum": [
"offset",
"angle"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type"
],
"type": "object"
},
"regular_joint_create": {
"description": "Create a geometry-solving regular joint in the root component using two distinct instance-context attachments or joint origins. All seven native motion families; offsets mm, angle and angular limits deg. Read back freshly resolved attachment graph, native parameters and root-space occurrence placement. Root/non-root sides must be unambiguous; both grounded and ancestor/descendant pairs are refused. Inferred joints are unsupported. Existing pending positions must be captured or reverted first. Before applying drive values, checks native joint-transform anchor offset magnitude/axiality and zero-angle axis collinearity. Native joint matrices have explicit provenance; physical angle/flip sense requires independent occurrence-geometry acceptance.",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"flipped": {
"type": "boolean"
},
"geometryOne": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"geometryTwo": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"locked": {
"type": "boolean"
},
"name": {
"type": "string"
},
"offset": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"type": {
"enum": [
"rigid",
"revolute",
"slider",
"cylindrical",
"pin_slot",
"planar",
"ball"
]
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type",
"geometryOne",
"geometryTwo"
],
"type": "object"
},
"regular_joint_edit": {
"description": "Redefine root-owned regular joint geometry, motion family, offsets, angle, flip or lock. Restore timeline in finally and verify after recompute. Use joint_edit for name, suppression, limits and drive values; joint_delete for deletion.",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"flipped": {
"type": "boolean"
},
"geometryOne": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"geometryTwo": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"joint": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"locked": {
"type": "boolean"
},
"offset": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetX": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetY": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"type": {
"enum": [
"rigid",
"revolute",
"slider",
"cylindrical",
"pin_slot",
"planar",
"ball"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"joint"
],
"type": "object"
},
"render_scene_inspect": {
"description": "Guarded main-thread read of current viewport camera, render settings and up to 32 environments. Optional detached world-mm camera is constructed and read back without viewport assignment. Missing fields return PARTIAL; observationComplete covers only bounded available scope. sceneWitnessComplete and renderQualified remain false. No rendering, workspace activation or scene writes.",
"properties": {
"camera": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"extents": {
"items": {
"maximum": 1000000000.0,
"minimum": 1e-06,
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"eye": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"space": {
"enum": [
"world"
],
"type": "string"
},
"target": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"type": {
"enum": [
"orthographic"
],
"type": "string"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
},
"upVector": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"type",
"space",
"unit",
"eye",
"target",
"upVector",
"extents"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angleUnit": {
"enum": [
"deg"
],
"type": "string"
},
"eye": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"perspectiveAngle": {
"exclusiveMinimum": 0,
"maximum": 179.999999999,
"type": "number"
},
"space": {
"enum": [
"world"
],
"type": "string"
},
"target": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"type": {
"enum": [
"perspective"
],
"type": "string"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
},
"upVector": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"type",
"space",
"unit",
"eye",
"target",
"upVector",
"perspectiveAngle",
"angleUnit"
],
"type": "object"
}
]
},
"maxEnvironments": {
"maximum": 32,
"minimum": 0,
"type": "integer"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"target"
],
"type": "object"
},
"rigid_group_create": {
"description": "Create a native rigid group from exact occurrence instances; includeChildren defaults true.",
"properties": {
"includeChildren": {
"type": "boolean"
},
"name": {
"type": "string"
},
"occurrences": {
"items": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 2,
"type": "array"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"occurrences"
],
"type": "object"
},
"rigid_group_delete": {
"description": "Delete an exact rigid group with transaction recovery.",
"properties": {
"group": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"group"
],
"type": "object"
},
"rigid_group_edit": {
"description": "Rename or suppress an exact rigid group with transaction recovery.",
"properties": {
"group": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"suppressed": {
"type": "boolean"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"group"
],
"type": "object"
},
"sketch_constraint": {
"description": "Constrain entities in one sketch. midpoint order is point,line; symmetry order entity1,entity2,symmetryLine. fix sets one entity fixed.",
"properties": {
"entities": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"type": {
"enum": [
"horizontal",
"vertical",
"coincident",
"parallel",
"perpendicular",
"tangent",
"equal",
"concentric",
"collinear",
"midpoint",
"symmetry",
"fix"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"type",
"entities"
],
"type": "object"
},
"sketch_create": {
"description": "Create a native component-definition sketch on an origin/construction plane or planar face. Coordinates in subsequent geometry are sketch-space mm.",
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target"
],
"type": "object"
},
"sketch_curve_edit": {
"description": "Edit one native sketch curve with sketch-space mm pick. trim removes the nearest segment; extend chooses nearest endpoint; split requires an interior on-curve point; break uses neighboring intersections. Fresh replacement refs are returned; original may be deleted. In-place extend returns the original with a fresh ref only after its geometry change survives recompute. No change or empty break/split fails. Full trim deletion requires allowDelete true. Linked/derived/deferred-compute geometry refused.",
"properties": {
"action": {
"enum": [
"trim",
"extend",
"split",
"break"
]
},
"allowDelete": {
"type": "boolean"
},
"createConstraints": {
"type": "boolean"
},
"curve": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"pick": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sketch": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"sketch",
"curve",
"action",
"pick"
],
"type": "object"
},
"sketch_diagnostics": {
"description": "Read native sketch health/message, fully-constrained/fixed/linked/reference flags, geometric constraints and driving dimensions. Reports no solver DOF count or conflict-set explanation; no recompute/mutation.",
"properties": {
"sketch": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target",
"sketch"
],
"type": "object"
},
"sketch_dimension": {
"description": "Add driving dimensions. Distance uses two point references; radius/diameter one curve; angle two lines. Numeric expressions use mm or deg.",
"properties": {
"entities": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"expression": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"parameterName": {
"type": "string"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"type": {
"enum": [
"distance",
"horizontal",
"vertical",
"radius",
"diameter",
"angle"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"type",
"entities",
"expression",
"position"
],
"type": "object"
},
"sketch_edit": {
"description": "Move sketch points/endpoints/centers in sketch-space mm, change radius or construction/fixed flags; solver failure aborts the operation.",
"properties": {
"changes": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"fixed": {
"type": "boolean"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"radius": {
"type": "number"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [],
"type": "object"
},
"entity": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"entity",
"changes"
],
"type": "object"
},
"sketch_geometry": {
"description": "Create a transactionally grouped set of sketch primitives. Numeric geometry uses mm and arc sweeps/polygon angles use deg.",
"properties": {
"items": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"point"
]
}
},
"required": [
"type",
"position"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"line"
]
}
},
"required": [
"type",
"start",
"end"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"rectangle"
]
}
},
"required": [
"type",
"start",
"end"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"radius": {
"exclusiveMinimum": 0,
"type": "number"
},
"type": {
"enum": [
"circle"
]
}
},
"required": [
"type",
"center",
"radius"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sweep": {
"type": "number"
},
"type": {
"enum": [
"arc"
]
}
},
"required": [
"type",
"center",
"start",
"sweep"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"type": "number"
},
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"radius": {
"exclusiveMinimum": 0,
"type": "number"
},
"sides": {
"maximum": 128,
"minimum": 3,
"type": "integer"
},
"type": {
"enum": [
"polygon"
]
}
},
"required": [
"type",
"center",
"radius",
"sides"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"slot"
]
},
"width": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"type",
"start",
"end",
"width"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"closed": {
"type": "boolean"
},
"construction": {
"type": "boolean"
},
"points": {
"items": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"maxItems": 128,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"spline"
]
}
},
"required": [
"type",
"points"
],
"type": "object"
}
]
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"items"
],
"type": "object"
},
"sketch_offset": {
"description": "Modern createOffsetInput/addOffset2. Curves must be native 2D, unique, in connected flow order (never reordered). Nonzero signed mm number/expression: positive right, negative left; a single circle/ellipse positive outside. Topology matched defaults true. Read back native signed distance, parent/child refs and controlling parameter after recompute. No retired Sketch.offset fallback.",
"properties": {
"curves": {
"items": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"distance": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"sketch": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"topologyMatched": {
"type": "boolean"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"sketch",
"curves",
"distance"
],
"type": "object"
},
"sketch_project": {
"description": "Project selected topology into a sketch with Fusion associative projection.",
"properties": {
"entities": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"entities"
],
"type": "object"
},
"transaction_probe": {
"description": "Verify runtime PTransaction abort+commit using temporary user parameters, remove probe data and compare semantic restoration. Required once per running add-in session before feature/sketch/atomic-batch writes. Returns fresh target; inspect again for current references.",
"properties": {},
"required": [
"op",
"sessionId",
"operationId",
"target"
],
"type": "object"
}
},
"sessionId": "str",
"success": "bool",
"transactions": "object"
},
"statusVerb": null,
"summary": "Discover typed mechanical operations, exact input schemas, units, recovery limitations and current add-in session ID.",
"timeoutSeconds": 30
},
{
"example": {},
"input": {
"operationId": "required str",
"sessionId": "required str"
},
"longRunning": false,
"name": "fusion_mech_operation_status",
"output": {
"currentSessionId": "str",
"historical": "bool",
"history": "durable identity/phase/timestamps",
"observedResult": "bounded unconfirmed current-session result or null",
"phase": "admitted|dispatched|executing|succeeded|failed|not_executed",
"reconciliationRequired": "bool",
"result": "recorded terminal result or null",
"state": "running|succeeded|failed|interrupted|reconciliation_required",
"success": "bool"
},
"statusVerb": null,
"summary": "Read durable typed-operation history by recorded sessionId and operationId, including after HTTP timeout or add-in restart. Returns the recorded request digest, source version, target identity, phase/timestamps and terminal result. Historical nonterminal work is interrupted/unknown and never replayed. Admission without a durable dispatch claim or uncertain persistence requires reconciliation. Missing history never proves no execution. This observational route bypasses lifecycle repair, window etiquette and the CAD queue; it never starts/restarts Fusion or dismisses dialogs. An unavailable add-in returns operation_status_unavailable with unknown outcome. SQLite recovery may repair only the app-owned journal. A native call monopolizing Python's GIL can still delay responses.",
"timeoutSeconds": 30
},
{
"example": {
"op": "inspect"
},
"input": {
"op": "required enum: inspect|inspect_entity|new_design|parameter_set|parameter_create|health|export|transaction_probe|sketch_create|sketch_geometry|sketch_constraint|sketch_dimension|sketch_project|sketch_edit|plane_create|feature_create|feature_edit|entity_delete|parameter_batch|component_create|occurrence_insert|occurrence_update|occurrence_delete|component_metadata|joint_create|joint_edit|joint_delete|interference|bom|bom_export|cad_import|mcmaster_discover|mcmaster_open|material_list|material_assign|rigid_group_create|rigid_group_edit|rigid_group_delete|assembly_properties|geometry_query|measure|sketch_curve_edit|sketch_offset|construction_axis|sketch_diagnostics|joint_origin_create|joint_origin_edit|joint_origin_delete|regular_joint_create|regular_joint_edit|motion_link_create|motion_link_edit|motion_link_delete|configuration_inspect|render_scene_inspect|exploded_view_plan|exploded_preview_create|exploded_preview_sample|exploded_preview_show|exploded_preview_dispose|exploded_preview_inspect",
"operationId": "required unique write ID; reuse unchanged for retry",
"operationSchemas": {
"assembly_properties": {
"description": "High-accuracy physical properties of whole root assembly (default) or an exact Component/Occurrence/BRepBody. Returns mass kg, volume mm3, area mm2, center of mass mm, mean density kg/mm3 and definition/instance coordinate scope.",
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"bom": {
"description": "Structured component-definition and instance BOM; quantities by actual identity, root bodies plus nested children; purchased metadata collapses subtrees unless exploded. Physical mass includes all unsuppressed bodies exactly once per instance. Includes exact current active configuration provenance; incomplete configuration scope refuses. Visibility does not remove quantity.",
"properties": {
"explodePurchased": {
"type": "boolean"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"bom_export": {
"description": "Export flat grouped purchasing rows or structured parent/path/depth instance rows and supplier provenance to CSV with exclusive/atomic publication. This external effect is separate from model transactions. Both CSV modes include document/revision and current active configuration table/row provenance.",
"properties": {
"explodePurchased": {
"type": "boolean"
},
"filename": {
"type": "string"
},
"mode": {
"enum": [
"flat",
"structured"
]
},
"overwrite": {
"type": "boolean"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"filename"
],
"type": "object"
},
"cad_import": {
"description": "Import a pre-downloaded local STEP/SAT into a new wrapper component in Hybrid design. Validate optional expected SHA-256, record actual source/hash/supplier metadata, preserve camera, measure model recovery. Does not fetch URLs or create cloud documents. Returns a representative root-context occurrence and all affectedOccurrences when the parent definition is reused.",
"properties": {
"asPurchased": {
"type": "boolean"
},
"filename": {
"type": "string"
},
"name": {
"type": "string"
},
"parent": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"provenance": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"supplier": {
"type": "string"
},
"supplierPartNumber": {
"type": "string"
}
},
"required": [
"supplier",
"supplierPartNumber",
"sourceUrl"
],
"type": "object"
},
"sha256": {
"type": "string"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"filename",
"provenance"
],
"type": "object"
},
"component_create": {
"description": "Create a native internal component and its first occurrence in a Hybrid design. parent is a component definition; edits to it affect every instance. Returns a representative root-context occurrence and all affectedOccurrences when the parent definition is reused.",
"properties": {
"metadata": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"asPurchased": {
"type": "boolean"
},
"description": {
"type": "string"
},
"excludeFromBom": {
"type": "boolean"
},
"name": {
"type": "string"
},
"partNumber": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"supplier": {
"type": "string"
},
"supplierPartNumber": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": {
"type": "string"
},
"parent": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"name"
],
"type": "object"
},
"component_metadata": {
"description": "Update component-definition name/part number/description and persistent supplier or BOM attributes. Shared occurrences all see this metadata.",
"properties": {
"changes": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"asPurchased": {
"type": "boolean"
},
"description": {
"type": "string"
},
"excludeFromBom": {
"type": "boolean"
},
"name": {
"type": "string"
},
"partNumber": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"supplier": {
"type": "string"
},
"supplierPartNumber": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"component": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"changes"
],
"type": "object"
},
"configuration_inspect": {
"description": "Read the loaded Design configuration graph without activation or recompute: ordinary rows, the separate native reserved test row, all supported typed cells including inactive/test cells, exact controlled-source links and current ordinary row. Unreadable fields and unknown/theme/hierarchical/inserted scopes remain explicit incomplete diagnostics. Configuration lifecycle and configured-design model mutations remain disabled pending native recovery/archive gates.",
"properties": {},
"required": [
"op",
"target"
],
"type": "object"
},
"construction_axis": {
"description": "Create a parametric axis from native references (edge/circular face/two intersecting planes/two distinct points). Root-space external geometry requires exact occurrence context. For cross-component geometry into a non-root target component, creationOccurrence must identify a root-context instance of that target. Returns component-space native axis geometry/health. No direct-only infinite-line or preview snap APIs.",
"properties": {
"component": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"creationOccurrence": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entities": {
"items": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 2,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"type": {
"enum": [
"edge",
"circular_face",
"two_planes",
"two_points"
]
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"type",
"entities"
],
"type": "object"
},
"entity_delete": {
"description": "Delete sketch geometry or independently deletable timeline features. Model transaction and semantic recovery cover downstream failures; document and external file deletion are excluded.",
"properties": {
"entity": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"entity"
],
"type": "object"
},
"exploded_preview_create": {
"description": "Create finite copied solid-BRep presentation graphics in the exact active blank unsaved Design proven by a committed current-session new_design result. Regenerates the guarded source plan; leaves source active. Exclusive session lease, no source moves/visibility writes, no model transaction, automatic document close, render or capture. Live capability and native backend qualification are separate from durable operation receipts.",
"properties": {
"creationOperationId": {
"type": "string"
},
"expectedPlanId": {
"type": "string"
},
"planner": {
"additionalProperties": false,
"properties": {
"playback": {
"enum": [
"explode",
"assemble"
],
"type": "string"
},
"sampleTimes": {
"items": {
"maximum": 3600,
"minimum": 0,
"type": "number"
},
"maxItems": 62,
"type": "array"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"exclusiveMinimum": 0,
"maximum": 3600,
"type": "number"
},
"instruction": {
"type": "string"
},
"moves": {
"items": {
"additionalProperties": false,
"properties": {
"direction": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"distance": {
"exclusiveMinimum": 0,
"maximum": 1000000.0,
"type": "number"
},
"frame": {
"enum": [
"world",
"parent",
"local"
],
"type": "string"
},
"occurrence": {
"description": "Exact guarded occurrence reference from inspect; every repeated/nested instance is distinct.",
"type": "object"
}
},
"required": [
"occurrence",
"direction",
"distance",
"frame"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"durationSeconds",
"moves"
],
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"type": "array"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
}
},
"required": [
"unit",
"steps"
],
"type": "object"
},
"sessionId": {
"type": "string"
},
"sourceTarget": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sourceTarget",
"creationOperationId",
"expectedPlanId",
"planner"
],
"type": "object"
},
"exploded_preview_dispose": {
"description": "Delete only the exact retained graphics tree and leave the blank document open for caller. Supports a narrowly proven cleanup after unresolved terminal storage without rewriting that history; no global Undo or close. Requires the current controller capability, presentation target, generation and a durable operation ID. Old-session native resources are never rebound.",
"properties": {
"expectedGeneration": {
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"previewId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"previewId",
"expectedGeneration"
],
"type": "object"
},
"exploded_preview_inspect": {
"description": "Main-thread live preview ownership/geometry/history observation. Cached operation receipts do not establish current graphics liveness. Old-session history remains separately readable through mech_operation_status; no native reference adoption or lifecycle repair is provided here.",
"properties": {
"previewId": {
"type": "string"
},
"sessionId": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"previewId"
],
"type": "object"
},
"exploded_preview_sample": {
"description": "Apply one server-stored absolute sample to exact-owned graphics; preserve active document. Source must remain unchanged. Requires the current controller capability, presentation target, generation and a durable operation ID. Old-session native resources are never rebound.",
"properties": {
"expectedGeneration": {
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"previewId": {
"type": "string"
},
"sampleIndex": {
"maximum": 63,
"minimum": 0,
"type": "integer"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"previewId",
"expectedGeneration",
"sampleIndex"
],
"type": "object"
},
"exploded_preview_show": {
"description": "Explicitly activate the exact-owned presentation in Fusion; refuse an intervening foreign active document. No OS foreground, camera change or capture. Requires the current controller capability, presentation target, generation and a durable operation ID. Old-session native resources are never rebound.",
"properties": {
"expectedGeneration": {
"maximum": 1000000000,
"minimum": 0,
"type": "integer"
},
"previewId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"previewId",
"expectedGeneration"
],
"type": "object"
},
"exploded_view_plan": {
"description": "Read-only source-bound exploded assembly plan. Normalized translation directions in immutable home world/parent/local axes; simultaneous moves within ordered steps. Descendants inherit ancestor translations once, plus own moves. Bounded deterministic sample matrices and exact home reverse endpoint. No native moves, graphics, BOM quantity changes, render/video or storyboard creation. Complete configuration identity required.",
"properties": {
"playback": {
"enum": [
"explode",
"assemble"
],
"type": "string"
},
"sampleTimes": {
"items": {
"maximum": 3600,
"minimum": 0,
"type": "number"
},
"maxItems": 62,
"type": "array"
},
"sessionId": {
"type": "string"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"durationSeconds": {
"exclusiveMinimum": 0,
"maximum": 3600,
"type": "number"
},
"instruction": {
"type": "string"
},
"moves": {
"items": {
"additionalProperties": false,
"properties": {
"direction": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"distance": {
"exclusiveMinimum": 0,
"maximum": 1000000.0,
"type": "number"
},
"frame": {
"enum": [
"world",
"parent",
"local"
],
"type": "string"
},
"occurrence": {
"description": "Exact guarded occurrence reference from inspect; every repeated/nested instance is distinct.",
"type": "object"
}
},
"required": [
"occurrence",
"direction",
"distance",
"frame"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"durationSeconds",
"moves"
],
"type": "object"
},
"maxItems": 32,
"minItems": 1,
"type": "array"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
}
},
"required": [
"op",
"sessionId",
"target",
"unit",
"steps"
],
"type": "object"
},
"export": {
"description": "Export entire design using runtime-checked API. Preflight and unique same-filesystem staging preserve the destination on failure; publish only nonempty verified output. Availability differs by Fusion build. STL numeric coordinates use mm.",
"properties": {
"format": {
"default": "step",
"enum": [
"step",
"stl",
"3mf",
"f3d",
"iges",
"sat",
"smt",
"usdz",
"fbx",
"skp"
]
},
"outputPath": {
"type": "string"
},
"overwrite": {
"default": false,
"type": "boolean"
},
"refinement": {
"default": "medium",
"enum": [
"low",
"medium",
"high"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"outputPath"
],
"type": "object"
},
"feature_create": {
"description": "Create a typed native solid feature. All length quantities are mm (or expressions), angles deg. Cut/intersect require explicit participant bodies. Join needs a single existing component body; combine selects multiple bodies explicitly. Feature availability is runtime-checked; missing APIs fail before commit.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"direction": {
"enum": [
"positive",
"negative",
"symmetric"
]
},
"distance": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"taper": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"extrude"
]
}
},
"required": [
"type",
"profiles",
"distance"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"revolve"
]
}
},
"required": [
"type",
"profiles",
"axis",
"angle"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"edges": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"radius": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"fillet"
]
}
},
"required": [
"type",
"edges",
"radius"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"distance": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"edges": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"chamfer"
]
}
},
"required": [
"type",
"edges",
"distance"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"faces": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"thickness": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"type": {
"enum": [
"shell"
]
}
},
"required": [
"type",
"faces",
"thickness"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"depth": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"diameter": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"points": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"hole"
]
}
},
"required": [
"type",
"points",
"diameter",
"depth",
"bodies"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"loft"
]
}
},
"required": [
"type",
"profiles"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"new_body",
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"path": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"profiles": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"sweep"
]
}
},
"required": [
"type",
"profiles",
"path"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"body": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keepTools": {
"type": "boolean"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operation": {
"enum": [
"join",
"cut",
"intersect"
]
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"tools": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"type": {
"enum": [
"combine"
]
}
},
"required": [
"type",
"body",
"tools",
"operation"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"extend": {
"type": "boolean"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"split"
]
}
},
"required": [
"type",
"bodies",
"plane"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"origin": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"translation": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"move"
]
}
},
"required": [
"type",
"bodies"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"mirror"
]
}
},
"required": [
"type",
"bodies",
"plane"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"axis2": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"count": {
"maximum": 1000,
"minimum": 2,
"type": "integer"
},
"count2": {
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"spacing": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"spacing2": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"rectangular_pattern"
]
}
},
"required": [
"type",
"bodies",
"axis",
"count",
"spacing"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"bodies": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"count": {
"maximum": 1000,
"minimum": 2,
"type": "integer"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"circular_pattern"
]
}
},
"required": [
"type",
"bodies",
"axis",
"count"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"faces": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"tangentChain": {
"type": "boolean"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"draft"
]
}
},
"required": [
"type",
"faces",
"plane",
"angle"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"designation": {
"type": "string"
},
"faces": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"internal": {
"type": "boolean"
},
"modeled": {
"type": "boolean"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
},
"threadClass": {
"type": "string"
},
"threadType": {
"type": "string"
},
"type": {
"enum": [
"thread"
]
}
},
"required": [
"type",
"faces",
"internal",
"threadType",
"designation",
"threadClass"
],
"type": "object"
}
],
"properties": {
"angle": {},
"axis": {},
"axis2": {},
"bodies": {},
"body": {},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"count": {},
"count2": {},
"depth": {},
"designation": {},
"diameter": {},
"direction": {},
"distance": {},
"edges": {},
"extend": {},
"faces": {},
"internal": {},
"keepTools": {},
"modeled": {},
"name": {
"type": "string"
},
"operation": {},
"origin": {},
"path": {},
"plane": {},
"points": {},
"profiles": {},
"radius": {},
"spacing": {},
"spacing2": {},
"tangentChain": {},
"taper": {},
"thickness": {},
"threadClass": {},
"threadType": {},
"tools": {},
"translation": {},
"type": {
"enum": [
"extrude",
"revolve",
"fillet",
"chamfer",
"shell",
"hole",
"loft",
"sweep",
"combine",
"split",
"move",
"mirror",
"rectangular_pattern",
"circular_pattern",
"draft",
"thread"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type"
],
"type": "object"
},
"feature_edit": {
"description": "Rename/suppress a feature or change expressions of model parameters whose createdBy is that exact feature; read health and abort on downstream errors.",
"properties": {
"feature": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"parameters": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"suppressed": {
"type": "boolean"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"feature"
],
"type": "object"
},
"geometry_query": {
"description": "Complete body-scoped topology query, no arbitrary first-match selection. selection one (default) refuses zero/multiple matches; many may return empty. Geometry types are exact native types; size ranges inclusive in mm/mm2, near is minimum distance in the explicit frame; direction is outward planar face normal or linear edge tangent. Returned refs retain instance context even for component-space filters. Exceeding maxResults fails rather than truncating.",
"properties": {
"body": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"filters": {
"additionalProperties": false,
"properties": {
"area": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"max": {
"minimum": 0,
"type": "number"
},
"min": {
"minimum": 0,
"type": "number"
}
},
"required": [],
"type": "object"
},
"direction": {
"additionalProperties": false,
"properties": {
"orientation": {
"enum": [
"same",
"parallel"
]
},
"tolerance": {
"maximum": 90,
"minimum": 0,
"type": "number"
},
"vector": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"vector"
],
"type": "object"
},
"length": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"max": {
"minimum": 0,
"type": "number"
},
"min": {
"minimum": 0,
"type": "number"
}
},
"required": [],
"type": "object"
},
"near": {
"additionalProperties": false,
"properties": {
"point": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"tolerance": {
"minimum": 0,
"type": "number"
}
},
"required": [
"point",
"tolerance"
],
"type": "object"
},
"radius": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"max": {
"minimum": 0,
"type": "number"
},
"min": {
"minimum": 0,
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": {
"enum": [
"Plane",
"Cylinder",
"Cone",
"Sphere",
"Torus",
"NurbsSurface",
"Line3D",
"Arc3D",
"Circle3D",
"Ellipse3D",
"EllipticalArc3D",
"NurbsCurve3D",
"Point3D",
"degenerate"
]
}
},
"required": [],
"type": "object"
},
"kind": {
"enum": [
"faces",
"edges",
"vertices"
]
},
"maxResults": {
"maximum": 1024,
"minimum": 1,
"type": "integer"
},
"selection": {
"enum": [
"one",
"many"
]
},
"space": {
"enum": [
"root",
"component"
]
}
},
"required": [
"op",
"target",
"body",
"kind",
"space"
],
"type": "object"
},
"health": {
"description": "Read timeline warnings/errors. recompute:true also requires current target revision, sessionId and operationId.",
"properties": {
"recompute": {
"default": false,
"type": "boolean"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"inspect": {
"description": "Inspect the active Design without mutation. Returns target identity/revision, native component-space bodies and occurrence transforms, parameters and feature health.",
"properties": {},
"required": [
"op"
],
"type": "object"
},
"inspect_entity": {
"properties": {
"entity": {
"description": "Exact reference returned by inspect; resolves uniquely with document/revision/type/occurrence guards.",
"type": "object"
}
},
"required": [
"op",
"target",
"entity"
],
"type": "object"
},
"interference": {
"description": "Analyze root-context occurrences/body proxies; returns overlap volume mm3 or touching. Does not create interference bodies.",
"properties": {
"entities": {
"items": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 2,
"type": "array"
},
"includeTouching": {
"type": "boolean"
},
"volumeTolerance": {
"minimum": 0,
"type": "number"
}
},
"required": [
"op",
"target",
"entities"
],
"type": "object"
},
"joint_create": {
"description": "Create an as-built joint without moving occurrences. Non-rigid motion requires explicit joint geometry; x/y/z are joint-coordinate directions. Limits and drive values use mm/deg. Seven native motion types; ball uses joint Z pitch/X yaw; planar uses native primary slide direction reported on readback. Use regular_joint_create for geometry-solving placement.",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"rigid"
]
}
},
"required": [
"type"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"revolute"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"slider"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"cylindrical"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"pin_slot"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"planar"
]
}
},
"required": [
"type",
"geometry"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"sessionId": {
"type": "string"
},
"suppressed": {
"type": "boolean"
},
"target": {
"type": "object"
},
"type": {
"enum": [
"ball"
]
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"type",
"geometry"
],
"type": "object"
}
],
"properties": {
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"geometry": {
"additionalProperties": false,
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"type": "string"
},
"occurrenceOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"occurrenceTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"type": {
"enum": [
"rigid",
"revolute",
"slider",
"cylindrical",
"pin_slot",
"planar",
"ball"
]
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type",
"occurrenceOne",
"occurrenceTwo"
],
"type": "object"
},
"joint_delete": {
"description": "Delete one selected Joint or AsBuiltJoint with recovery verification.",
"properties": {
"joint": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"joint"
],
"type": "object"
},
"joint_edit": {
"description": "Edit joint name/suppression, enabled limits, rest and drive values; wrong motion type or out-of-limit values fail with recovery. For driven root joints, active motion links must preserve their settings and their partner motion must follow the native ratio; a coupling mismatch aborts.",
"properties": {
"joint": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"suppressed": {
"type": "boolean"
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"joint"
],
"type": "object"
},
"joint_origin_create": {
"description": "Create a native component-definition joint origin from guarded native geometry, with mm offsets/deg angle and optional straight axis references. Child occurrence origin references are exposed by inspect_entity(occurrence).",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"component": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"flipped": {
"type": "boolean"
},
"geometry": {
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"offsetX": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetY": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetZ": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"xAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"zAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"geometry"
],
"type": "object"
},
"joint_origin_delete": {
"description": "Delete a native joint origin; unhealthy downstream joints cause transaction rollback.",
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"origin"
],
"type": "object"
},
"joint_origin_edit": {
"description": "Edit a native joint origin definition; rolls before its timeline item and restores the original marker in finally. Recomputes and verifies attachment, axes, offsets, angle, name and flip.",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"flipped": {
"type": "boolean"
},
"geometry": {
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"offsetX": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetY": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetZ": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"xAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"zAxisEntity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"origin"
],
"type": "object"
},
"material_assign": {
"description": "Assign a loaded library or document material to an exact native Component/BRepBody; verify material ID readback with model transaction recovery. Query assembly_properties for resulting mass.",
"properties": {
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"libraryId": {
"type": "string"
},
"materialId": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"entity",
"materialId"
],
"type": "object"
},
"material_list": {
"description": "List loaded material libraries and matching materials by stable library/material IDs. Omit libraryId for document materials.",
"properties": {
"libraryId": {
"type": "string"
},
"limit": {
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"query": {
"type": "string"
}
},
"required": [
"op",
"target"
],
"type": "object"
},
"mcmaster_discover": {
"description": "Discover Fusion native Insert McMaster-Carr command and requirements in the active design.",
"properties": {},
"required": [
"op"
],
"type": "object"
},
"mcmaster_open": {
"description": "Invoke Fusion native McMaster UI in the targeted Hybrid design. Interactive external operation: completion/insert/cancel stays with Fusion; inspect afterward. Idempotency records launch only.",
"properties": {},
"required": [
"op",
"sessionId",
"operationId",
"target"
],
"type": "object"
},
"measure": {
"description": "Native engineering minimum distance or angle in root assembly space. Non-root definition refs require an occurrence context. Distance needs2 entities; angle needs2 lines/planes or3 points (second apex). Returns mm/deg and native witness positions in root mm. witnessValidation identifies native points or native geometry directions used for valid parallel angles with degenerate native points; degenerate point angles and unavailable/inconsistent witnesses fail.",
"properties": {
"entities": {
"items": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"space": {
"enum": [
"root"
]
},
"type": {
"enum": [
"distance",
"angle"
]
}
},
"required": [
"op",
"target",
"type",
"space",
"entities"
],
"type": "object"
},
"motion_link_create": {
"description": "Create a native motion link between two root-owned joints, or two different motions of jointOne when jointTwo is omitted. Positive ratio magnitudes use mm for translation and deg for rotation; reversed selects opposite direction. Requires the November 2025+ API; no script fallback.",
"properties": {
"jointOne": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"jointTwo": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"motionOne": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"motionTwo": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"reversed": {
"type": "boolean"
},
"valueOne": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"valueTwo": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"jointOne",
"motionOne",
"motionTwo",
"valueOne",
"valueTwo"
],
"type": "object"
},
"motion_link_delete": {
"description": "Delete a root-owned motion link under the same transaction/recovery contract.",
"properties": {
"link": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"link"
],
"type": "object"
},
"motion_link_edit": {
"description": "Edit a root-owned motion link ratio, degree-of-freedom pair, direction, name or suppression. Joint membership is immutable; recreate the link to change members. Verify exact joint identities, ratio, flags and health.",
"properties": {
"link": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"motionOne": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"motionTwo": {
"enum": [
"rotation",
"slide",
"primarySlide",
"secondarySlide",
"pitch",
"roll",
"yaw"
]
},
"name": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"reversed": {
"type": "boolean"
},
"suppressed": {
"type": "boolean"
},
"valueOne": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"valueTwo": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"link"
],
"type": "object"
},
"new_design": {
"description": "Create an unnamed unsaved parametric hybrid Design; name is retained as requestedName metadata to keep failure recovery free of save dialogs. Optional box dimensions in mm create a driving-parameter fixture. Never edits an existing document.",
"properties": {
"box": {
"additionalProperties": false,
"properties": {
"depth": {
"exclusiveMinimum": 0,
"type": "number"
},
"height": {
"exclusiveMinimum": 0,
"type": "number"
},
"width": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"width",
"height",
"depth"
],
"type": "object"
},
"name": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"operationId"
],
"type": "object"
},
"occurrence_delete": {
"description": "Delete one selected occurrence through the shared transaction executor.",
"properties": {
"occurrence": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"occurrence"
],
"type": "object"
},
"occurrence_insert": {
"description": "Insert another occurrence of an existing definition; independentCopy:true uses Paste New to create a separate definition. Nested placement is in parent component coordinates. Returns a representative root-context occurrence and all affectedOccurrences when the parent definition is reused.",
"properties": {
"component": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"independentCopy": {
"type": "boolean"
},
"parent": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"component"
],
"type": "object"
},
"occurrence_update": {
"description": "Set occurrence pose in its assembly context and capture position; explicit grounding/ungrounding. Grounded or constrained transforms fail with recovery.",
"properties": {
"grounded": {
"type": "boolean"
},
"groundedToParent": {
"type": "boolean"
},
"occurrence": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"transform": {
"additionalProperties": false,
"description": "Absolute rotation about the given nonzero axis through origin (deg), then translation (mm). Create/insert use parent component coordinates; updates use the selected occurrence assembly context.",
"properties": {
"angle": {
"type": "number"
},
"axis": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"occurrence"
],
"type": "object"
},
"parameter_batch": {
"description": "Atomic sequential create/set/delete parameter edits with one recompute+health gate; delete supports user parameters only. Any failure aborts all edits and reports semantic recovery.",
"properties": {
"changes": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"create"
]
},
"comment": {
"type": "string"
},
"expression": {
"type": "string"
},
"name": {
"type": "string"
},
"unit": {
"enum": [
"mm",
"deg",
"kg",
""
]
}
},
"required": [
"action",
"name",
"expression",
"unit"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"set"
]
},
"expression": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"action",
"name",
"expression"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"delete"
]
},
"name": {
"type": "string"
}
},
"required": [
"action",
"name"
],
"type": "object"
}
]
},
"maxItems": 128,
"minItems": 1,
"type": "array"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"changes"
],
"type": "object"
},
"parameter_create": {
"properties": {
"comment": {
"type": "string"
},
"expression": {
"type": "string"
},
"name": {
"type": "string"
},
"unit": {
"enum": [
"mm",
"deg",
"kg",
""
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"name",
"expression",
"unit"
],
"type": "object"
},
"parameter_set": {
"description": "Set an expression, recompute and inspect health. Failure restores old expression and reports a semantic recovery witness; not an atomic transaction.",
"properties": {
"expression": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"name",
"expression"
],
"type": "object"
},
"plane_create": {
"description": "Create offset plane (offset in mm) or angled plane around axis (angle in deg).",
"oneOf": [
{
"additionalProperties": false,
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"offset": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"offset"
]
}
},
"required": [
"type",
"offset"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"op": {
"type": "string"
},
"operationId": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"sessionId": {
"type": "string"
},
"target": {
"required": [
"documentId",
"revision"
],
"type": "object"
},
"type": {
"enum": [
"angle"
]
}
},
"required": [
"type",
"axis",
"angle"
],
"type": "object"
}
],
"properties": {
"angle": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"axis": {
"oneOf": [
{
"enum": [
"x",
"y",
"z"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"offset": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
},
"type": {
"enum": [
"offset",
"angle"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type"
],
"type": "object"
},
"regular_joint_create": {
"description": "Create a geometry-solving regular joint in the root component using two distinct instance-context attachments or joint origins. All seven native motion families; offsets mm, angle and angular limits deg. Read back freshly resolved attachment graph, native parameters and root-space occurrence placement. Root/non-root sides must be unambiguous; both grounded and ancestor/descendant pairs are refused. Inferred joints are unsupported. Existing pending positions must be captured or reverted first. Before applying drive values, checks native joint-transform anchor offset magnitude/axiality and zero-angle axis collinearity. Native joint matrices have explicit provenance; physical angle/flip sense requires independent occurrence-geometry acceptance.",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"flipped": {
"type": "boolean"
},
"geometryOne": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"geometryTwo": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"locked": {
"type": "boolean"
},
"name": {
"type": "string"
},
"offset": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"pitchLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"pitchValue": {
"type": "number"
},
"primarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"primarySlideValue": {
"type": "number"
},
"rollLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rollValue": {
"type": "number"
},
"rotationLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"rotationValue": {
"type": "number"
},
"secondarySlideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"secondarySlideValue": {
"type": "number"
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"slideLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"slideValue": {
"type": "number"
},
"type": {
"enum": [
"rigid",
"revolute",
"slider",
"cylindrical",
"pin_slot",
"planar",
"ball"
]
},
"yawLimits": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"maximum": {
"type": "number"
},
"maximumEnabled": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"minimumEnabled": {
"type": "boolean"
},
"rest": {
"type": "number"
},
"restEnabled": {
"type": "boolean"
}
},
"required": [],
"type": "object"
},
"yawValue": {
"type": "number"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"type",
"geometryOne",
"geometryTwo"
],
"type": "object"
},
"regular_joint_edit": {
"description": "Redefine root-owned regular joint geometry, motion family, offsets, angle, flip or lock. Restore timeline in finally and verify after recompute. Use joint_edit for name, suppression, limits and drive values; joint_delete for deletion.",
"properties": {
"angle": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"axis": {
"enum": [
"x",
"y",
"z"
]
},
"flipped": {
"type": "boolean"
},
"geometryOne": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"geometryTwo": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"edge": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"entity": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"keyPoint": {
"enum": [
"center",
"start",
"middle",
"end"
]
}
},
"required": [
"entity"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"origin": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"origin"
],
"type": "object"
}
]
},
"joint": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"locked": {
"type": "boolean"
},
"offset": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetX": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"offsetY": {
"description": "Number in mm (angle in deg), or a dimensionally valid Fusion parameter expression.",
"oneOf": [
{
"type": "number"
},
{
"maxLength": 512,
"minLength": 1,
"type": "string"
}
]
},
"slideAxis": {
"enum": [
"x",
"y",
"z"
]
},
"type": {
"enum": [
"rigid",
"revolute",
"slider",
"cylindrical",
"pin_slot",
"planar",
"ball"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"joint"
],
"type": "object"
},
"render_scene_inspect": {
"description": "Guarded main-thread read of current viewport camera, render settings and up to 32 environments. Optional detached world-mm camera is constructed and read back without viewport assignment. Missing fields return PARTIAL; observationComplete covers only bounded available scope. sceneWitnessComplete and renderQualified remain false. No rendering, workspace activation or scene writes.",
"properties": {
"camera": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"extents": {
"items": {
"maximum": 1000000000.0,
"minimum": 1e-06,
"type": "number"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"eye": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"space": {
"enum": [
"world"
],
"type": "string"
},
"target": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"type": {
"enum": [
"orthographic"
],
"type": "string"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
},
"upVector": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"type",
"space",
"unit",
"eye",
"target",
"upVector",
"extents"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angleUnit": {
"enum": [
"deg"
],
"type": "string"
},
"eye": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"perspectiveAngle": {
"exclusiveMinimum": 0,
"maximum": 179.999999999,
"type": "number"
},
"space": {
"enum": [
"world"
],
"type": "string"
},
"target": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"type": {
"enum": [
"perspective"
],
"type": "string"
},
"unit": {
"enum": [
"mm"
],
"type": "string"
},
"upVector": {
"items": {
"maximum": 1000000000.0,
"minimum": -1000000000.0,
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
}
},
"required": [
"type",
"space",
"unit",
"eye",
"target",
"upVector",
"perspectiveAngle",
"angleUnit"
],
"type": "object"
}
]
},
"maxEnvironments": {
"maximum": 32,
"minimum": 0,
"type": "integer"
},
"sessionId": {
"type": "string"
},
"target": {
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string"
},
"revision": {
"type": "string"
}
},
"required": [
"documentId",
"revision"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"target"
],
"type": "object"
},
"rigid_group_create": {
"description": "Create a native rigid group from exact occurrence instances; includeChildren defaults true.",
"properties": {
"includeChildren": {
"type": "boolean"
},
"name": {
"type": "string"
},
"occurrences": {
"items": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 2,
"type": "array"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"occurrences"
],
"type": "object"
},
"rigid_group_delete": {
"description": "Delete an exact rigid group with transaction recovery.",
"properties": {
"group": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"group"
],
"type": "object"
},
"rigid_group_edit": {
"description": "Rename or suppress an exact rigid group with transaction recovery.",
"properties": {
"group": {
"description": "Guarded reference from inspect in this document/revision; occurrence references retain instance context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"suppressed": {
"type": "boolean"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"group"
],
"type": "object"
},
"sketch_constraint": {
"description": "Constrain entities in one sketch. midpoint order is point,line; symmetry order entity1,entity2,symmetryLine. fix sets one entity fixed.",
"properties": {
"entities": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"type": {
"enum": [
"horizontal",
"vertical",
"coincident",
"parallel",
"perpendicular",
"tangent",
"equal",
"concentric",
"collinear",
"midpoint",
"symmetry",
"fix"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"type",
"entities"
],
"type": "object"
},
"sketch_create": {
"description": "Create a native component-definition sketch on an origin/construction plane or planar face. Coordinates in subsequent geometry are sketch-space mm.",
"properties": {
"component": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"name": {
"type": "string"
},
"plane": {
"oneOf": [
{
"enum": [
"xy",
"xz",
"yz"
]
},
{
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target"
],
"type": "object"
},
"sketch_curve_edit": {
"description": "Edit one native sketch curve with sketch-space mm pick. trim removes the nearest segment; extend chooses nearest endpoint; split requires an interior on-curve point; break uses neighboring intersections. Fresh replacement refs are returned; original may be deleted. In-place extend returns the original with a fresh ref only after its geometry change survives recompute. No change or empty break/split fails. Full trim deletion requires allowDelete true. Linked/derived/deferred-compute geometry refused.",
"properties": {
"action": {
"enum": [
"trim",
"extend",
"split",
"break"
]
},
"allowDelete": {
"type": "boolean"
},
"createConstraints": {
"type": "boolean"
},
"curve": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"pick": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sketch": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"sketch",
"curve",
"action",
"pick"
],
"type": "object"
},
"sketch_diagnostics": {
"description": "Read native sketch health/message, fully-constrained/fixed/linked/reference flags, geometric constraints and driving dimensions. Reports no solver DOF count or conflict-set explanation; no recompute/mutation.",
"properties": {
"sketch": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"target",
"sketch"
],
"type": "object"
},
"sketch_dimension": {
"description": "Add driving dimensions. Distance uses two point references; radius/diameter one curve; angle two lines. Numeric expressions use mm or deg.",
"properties": {
"entities": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"expression": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"parameterName": {
"type": "string"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"type": {
"enum": [
"distance",
"horizontal",
"vertical",
"radius",
"diameter",
"angle"
]
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"type",
"entities",
"expression",
"position"
],
"type": "object"
},
"sketch_edit": {
"description": "Move sketch points/endpoints/centers in sketch-space mm, change radius or construction/fixed flags; solver failure aborts the operation.",
"properties": {
"changes": {
"additionalProperties": false,
"minProperties": 1,
"properties": {
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"fixed": {
"type": "boolean"
},
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"radius": {
"type": "number"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [],
"type": "object"
},
"entity": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"entity",
"changes"
],
"type": "object"
},
"sketch_geometry": {
"description": "Create a transactionally grouped set of sketch primitives. Numeric geometry uses mm and arc sweeps/polygon angles use deg.",
"properties": {
"items": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"position": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"point"
]
}
},
"required": [
"type",
"position"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"line"
]
}
},
"required": [
"type",
"start",
"end"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"rectangle"
]
}
},
"required": [
"type",
"start",
"end"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"radius": {
"exclusiveMinimum": 0,
"type": "number"
},
"type": {
"enum": [
"circle"
]
}
},
"required": [
"type",
"center",
"radius"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"sweep": {
"type": "number"
},
"type": {
"enum": [
"arc"
]
}
},
"required": [
"type",
"center",
"start",
"sweep"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"angle": {
"type": "number"
},
"center": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"construction": {
"type": "boolean"
},
"radius": {
"exclusiveMinimum": 0,
"type": "number"
},
"sides": {
"maximum": 128,
"minimum": 3,
"type": "integer"
},
"type": {
"enum": [
"polygon"
]
}
},
"required": [
"type",
"center",
"radius",
"sides"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"construction": {
"type": "boolean"
},
"end": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"start": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"slot"
]
},
"width": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"type",
"start",
"end",
"width"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"closed": {
"type": "boolean"
},
"construction": {
"type": "boolean"
},
"points": {
"items": {
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"maxItems": 128,
"minItems": 2,
"type": "array"
},
"type": {
"enum": [
"spline"
]
}
},
"required": [
"type",
"points"
],
"type": "object"
}
]
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"items"
],
"type": "object"
},
"sketch_offset": {
"description": "Modern createOffsetInput/addOffset2. Curves must be native 2D, unique, in connected flow order (never reordered). Nonzero signed mm number/expression: positive right, negative left; a single circle/ellipse positive outside. Topology matched defaults true. Read back native signed distance, parent/child refs and controlling parameter after recompute. No retired Sketch.offset fallback.",
"properties": {
"curves": {
"items": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"distance": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
"sketch": {
"description": "Current guarded entity reference; root-space child geometry requires its exact occurrence context.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"topologyMatched": {
"type": "boolean"
}
},
"required": [
"op",
"target",
"sessionId",
"operationId",
"sketch",
"curves",
"distance"
],
"type": "object"
},
"sketch_project": {
"description": "Project selected topology into a sketch with Fusion associative projection.",
"properties": {
"entities": {
"items": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
},
"maxItems": 256,
"minItems": 1,
"type": "array"
},
"sketch": {
"description": "Reference returned by inspect/inspect_entity in this document revision; native component-definition references for authoring.",
"required": [
"documentId",
"revision",
"objectType"
],
"type": "object"
}
},
"required": [
"op",
"sessionId",
"operationId",
"target",
"sketch",
"entities"
],
"type": "object"
},
"transaction_probe": {
"description": "Verify runtime PTransaction abort+commit using temporary user parameters, remove probe data and compare semantic restoration. Required once per running add-in session before feature/sketch/atomic-batch writes. Returns fresh target; inspect again for current references.",
"properties": {},
"required": [
"op",
"sessionId",
"operationId",
"target"
],
"type": "object"
}
},
"sessionId": "required for writes from mech_capabilities",
"target": "existing-document writes: {documentId,revision} from inspect"
},
"longRunning": true,
"name": "fusion_mechanical",
"output": {
"data": "operation result including fresh target",
"durability": "terminalRecorded and recorded phase for durable writes",
"errorCode": "stable str on failure",
"operationId": "str on writes",
"outcome": "unknown or not_executed on storage/delivery failure",
"recovery": "reported on failed mutation",
"sessionId": "str",
"success": "bool"
},
"statusVerb": "fusion_mech_operation_status",
"summary": "Guarded main-thread parametric parts and assemblies: sketches, solid features, atomic parameter edits, component definitions/copies/placement, seven as-built joint motions and limits, rigid groups, interference, materials and assembly mass/center of mass, local supplier STEP/SAT import with SHA/provenance, native McMaster command, structured/flat BOM CSV, topology readback, health and safe exports. Geometry queries refuse ambiguous selections; root-space distance/angle measurements return witness points. Typed sketch trim/extend/split/break and signed modern offsets, reference-defined construction axes and native sketch constraint diagnostics are available through exact operation schemas. Regular geometry-solving joints, joint origins and native motion links have guarded typed operations, exact attachment/parameter readback and timeline restoration. Read-only configuration inspection and active-row BOM provenance are available; configuration lifecycle and configured-design model writes remain disabled pending native recovery/archive gates. Incomplete configuration scope also blocks complete BOM output. Typed model mutations use runtime-proven PTransaction recovery; transaction_probe verifies the backend (new_design does this automatically). Writes require sessionId,operationId and current target {documentId,revision}. Durable admission must commit before dispatch. Retry exact args with the same ID; query durable status after timeout. Old-session history is readable but never replayed. Storage failure after execution returns reconciliation-required, preserving available evidence without claiming rollback. References expire on model changes. Files/document lifecycle are outside model transactions.",
"timeoutSeconds": 300
},
{
"example": {},
"input": {
"boardId": "required from routing_state",
"expectDocument": "required exact board name",
"expectedRevision": "required from routing_state",
"parts": "required [{ref, x, y, rotation}] rotation in degrees or an EAGLE rotation like R90 / MR180"
},
"longRunning": false,
"name": "fusion_move_parts",
"output": {
"mismatched": "[{ref,want,got}]",
"moved": "[ref]",
"revision": "str",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Place parts on the live board: one MOVE (absolute, mm) and ROTATE per part, each its own undo step, then a fresh export reads every element back. The layout half of the AI flow's Fusion lane (adom-aiflow place land). Coordinates are Fusion's (y up).",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"clip": "required str (clip name without .mp3)"
},
"longRunning": false,
"name": "fusion_narrate",
"output": {
"clip": "str",
"file": "str",
"startedAt": "float"
},
"statusVerb": null,
"summary": "Play one bundled narration clip on the box now (the guided tour's voice): dock, dashboard, or any <beat>[-a|-b] clip in resources/demo-audio. A driver speaks the dock bar and dashboard lines with it before the tour starts. Returns startedAt (epoch seconds) so a recording can be cut on it; the tour's own narration stops it when a beat begins.",
"timeoutSeconds": 15
},
{
"example": {
"brdPath": "C:/Users/me/adom-lib/MyBoard.brd",
"schPath": "C:/Users/me/adom-lib/MyBoard.sch"
},
"input": {
"brdPath": "optional str (defaults to sibling .brd)",
"schPath": "required str (Windows path to .sch)"
},
"longRunning": false,
"name": "fusion_new_electronics_from_eagle",
"output": {
"imported": "list",
"success": "bool"
},
"statusVerb": null,
"summary": "Import a legacy EAGLE .sch (+ paired .brd) into a NEW Fusion electronics design so the parts INSTANTIATE (schematic + populated board, lands in the PCB editor). The ONLY way to author a board from EAGLE source: Document.newDesignFromLocal opens the schematic editor but does NOT instantiate parts, and the Fusion-native .fsch/.fbrd container is opaque binary you can't build offline. This fires Fusion's own ImportSCHAndBRDCmd and drives BOTH native Open dialogs (the .sch then the .brd) in the BACKGROUND via desktop_ui_click by accessible name (no foreground). Stage both files to Windows first (send_files). After: fusion_show_2d_board, RATSNEST + 'AUTO ;' to autoroute, fusion_show_3d_board for 3D. PREFLIGHT (1.10.20): refuses with eagle_files_missing before touching any dialog when either file is not on the Fusion machine; if the Open dialog does not accept the file the bridge cancels the dialog itself (open_dialog_stuck), so nothing is ever left on the user's screen. Prefer fusion_schematic {action:\"open\"}, which picks this route only when a .brd exists next to the .sch. ASYNC by contract (1.10.22): returns {started:true, runId, statusVerb} at once and runs the dialog-driven import on the exe; poll fusion_eagle_import_status {runId}. The record and the final reply carry documentName, partsExpected (elements in the .brd) and partsPlaced (read back from the board); success needs parts on the board (nothing_instantiated otherwise). Pass wait:true only from inside the exe.",
"timeoutSeconds": 200
},
{
"example": {
"body": "Please complete the Autodesk 2FA prompt on winvm - everything else is done.",
"title": "Fusion needs you"
},
"input": {
"body": "required str",
"level": "optional str info|warning|error",
"title": "optional str"
},
"longRunning": false,
"name": "fusion_notify_owner",
"output": {
"success": "bool",
"targets": "list"
},
"statusVerb": null,
"summary": "LAST-RESORT human escalation: toast the user's MAIN computer (fans out cross-ab to every peer on the relay, so it reaches them even when this bridge runs on an unattended VM). ONLY for true human walls - password/2FA entry, UAC elevation, a physical step. Exhaust programmatic options first (UIA background clicks, seat auto-resolve, warm-SSO sign-in). After sending, WAIT and poll fusion_readiness; do not re-toast within a few minutes.",
"timeoutSeconds": 20
},
{
"example": {
"filePath": "C:/Temp/TJA1050.brd"
},
"input": {
"filePath": "required str (WINDOWS path to the .brd, C:/...; must exist on the Fusion machine)"
},
"longRunning": true,
"name": "fusion_open_board",
"output": {
"activeDocument": "str",
"activeWorkspace": "str",
"filePath": "str",
"fileType": "str",
"nextSteps": "[str]",
"postOpenCheck": "{required, steps}",
"screenshots": "[{type,savedTo,sizeKB}] (sidecar shell) or postOpenScreenshot (exe shell)",
"success": "bool"
},
"statusVerb": null,
"summary": "Open a LOCAL legacy EAGLE .brd in Fusion's 2D board editor (dialog-free Document.newDesignFromLocal; a background open). NAV RULE: the schematic, 2D board and 3D board are VIEWS of ONE electronics design, not standalone files. For a team design open the DESIGN document (fusion_open_cloud_file / fusion_open_by_urn) and switch views with fusion_show_2d_board; this verb is for a .brd that exists on the Fusion machine (push it there first). Elements with an embedded library are instantiated as placed parts; embed <packages3d> + per-element package3d_urn for real 3D bodies, then fusion_show_3d_board. The bridge captures a post-open screenshot because Fusion can raise a blocking dialog the API cannot see.",
"timeoutSeconds": 60
},
{
"example": {
"urn": "urn:adsk.wipprod:fs.file:vf.xxxx?version=1"
},
"input": {
"intent": "optional \"mechanical\" | \"electronics\": what you meant to open. A DesignProductType is every mechanical design; the STOP-WRONG-FILE hint now fires only for the 3D leaf of an electronics chain (by name, or intent electronics); intent mechanical confirms the open (issue #86)",
"urn": "required str"
},
"longRunning": true,
"name": "fusion_open_by_urn",
"output": {
"output": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Open a cloud ELECTRONICS DESIGN by URN. PCB/ELECTRONICS NAV RULE: a board is NOT a standalone file - the schematic, 2D board and 3D board are VIEWS inside ONE electronics DESIGN. Open the DESIGN document first (fusion_open_cloud_file or fusion_open_by_urn), THEN switch to its schematic and its 2D board (fusion_show_2d_board) and 3D board (fusion_show_3d_board). A Select-Electronics-Design-File picker IS that design list of its schematic + board. An EMPTY 2D board usually means you opened a derivative or the wrong file, or it is out of sync - reopen the parent electronics DESIGN and switch to its board view; do NOT open a .brd or .sch as a standalone file.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_open_by_urn_note",
"output": {},
"statusVerb": null,
"summary": "(see fusion_open_by_urn)",
"timeoutSeconds": 30
},
{
"example": {
"fileName": "BQ25792",
"projectName": "Main"
},
"input": {
"fileName": "required str",
"folderPath": "optional str",
"projectName": "optional str (defaults to active project)"
},
"longRunning": true,
"name": "fusion_open_cloud_file",
"output": {
"documentName": "str",
"success": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Open a CLOUD file by name (the front door to every design flow). PCB/ELECTRONICS NAV RULE: open the electronics DESIGN document (EcadDesignProductType), never a child .brd/.sch/3D directly - then switch views with fusion_show_schematic / fusion_show_2d_board / fusion_show_3d_board. LONG-RUNNING: fire it, then poll fusion_get_app_state until activeDocument matches (cloud opens on electronics designs take 1-3 min). A crash-recovery modal can block the open - fusion_dismiss_blocking_dialogs.",
"timeoutSeconds": 240
},
{
"example": {
"filePath": "C:/Temp/part.f3d"
},
"input": {
"filePath": "required str (WINDOWS path)",
"intent": "optional \"mechanical\" | \"electronics\" (see fusion_open_by_urn)"
},
"longRunning": true,
"name": "fusion_open_design",
"output": {
"success": "bool"
},
"statusVerb": null,
"summary": "Open a LOCAL design file (routes through the add-in import). Prefer cloud flows (fusion_open_cloud_file) for team designs; this is for local .f3d/.step style files.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {
"filePath": "optional str (WINDOWS path to a .sch/.brd/.lbr; only acted on when an electronics editor is already active)",
"type": "optional str (\"status\", the default; other values are reserved)"
},
"longRunning": false,
"name": "fusion_open_electronics",
"output": {
"activeDocument": "{name,type}",
"activeWorkspace": "str",
"isElectronics": "bool",
"output": "str",
"productType": "str",
"result": "str (Electron.run output, filePath form only)",
"success": "bool"
},
"statusVerb": null,
"summary": "Read whether an ELECTRONICS editor (schematic, board or library) is the active workspace, so you know if Electron.* text commands and fusion_electron_run will work. With filePath, and ONLY when an electronics editor is already active, it also issues Electron.run EDIT on that file; otherwise it just reports the workspace. Prefer fusion_open_schematic / fusion_open_board / fusion_open_lbr to open files. The schematic, 2D board and 3D board are views of one electronics design.",
"timeoutSeconds": 30
},
{
"example": {
"filePath": "C:/Users/<user>/adom-lib/nRF54L15.lbr"
},
"input": {
"filePath": "required str (.lbr WINDOWS path C:/...; stage from container first)",
"symbolName": "optional str",
"verify": "optional bool"
},
"longRunning": false,
"name": "fusion_open_lbr",
"output": {
"postOpenScreenshot": "{savedTo}",
"success": "bool"
},
"statusVerb": null,
"summary": "Import an EAGLE .lbr library into Fusion's Electronics LIBRARY editor (Content Manager / Electronics Library workspace), not a PCB design. PITFALL: filePath MUST be a WINDOWS-local path (C:/...). The chip-fetcher/adom-lbr pipeline runs in the cloud container, and there is NO container-to-Windows push verb, so STAGE the .lbr onto Windows first (serve it on a proxied port + Invoke-WebRequest via shell_execute), then pass the C:/ path. PITFALL: an adom-lbr .lbr is 2D ONLY - symbol + footprint + a PLACEHOLDER 3D package; the real 3D chip is NOT attached (that needs a Fusion cloud URN). To attach the 3D, see the 'fusion-libraries' skill. Pass verify:true to round-trip-confirm Fusion parsed the deviceset, then check fusion_get_app_state (activeWorkspace 'Electronics Library').",
"timeoutSeconds": 50
},
{
"example": {
"filePath": "C:/Temp/TJA1050.sch"
},
"input": {
"filePath": "required str (WINDOWS path to the .sch, C:/...; must exist on the Fusion machine)"
},
"longRunning": true,
"name": "fusion_open_schematic",
"output": {
"activeDocument": "str",
"activeWorkspace": "str",
"filePath": "str",
"fileType": "str",
"nextSteps": "[str]",
"postOpenCheck": "{required, steps}",
"screenshots": "[{type,savedTo,sizeKB}] (sidecar shell) or postOpenScreenshot (exe shell)",
"success": "bool"
},
"statusVerb": null,
"summary": "Open a LOCAL legacy EAGLE .sch in Fusion's Schematic Editor (dialog-free Document.newDesignFromLocal; a background open). NAV RULE: the schematic, 2D board and 3D board are VIEWS of ONE electronics design, not standalone files. For a team design open the DESIGN document (fusion_open_cloud_file / fusion_open_by_urn) and switch views with fusion_show_schematic; this verb is for a .sch that exists on the Fusion machine (push it there first). Drive the opened sheet with fusion_electron_run (WINDOW FIT, DISPLAY ALL). The bridge captures a post-open screenshot because Fusion can raise a blocking dialog the API cannot see.",
"timeoutSeconds": 60
},
{
"example": {
"accuracy": "low"
},
"input": {
"accuracy": "optional low|medium|high|veryhigh (default low)",
"names": "optional [str] component names to measure (default all)"
},
"longRunning": false,
"name": "fusion_physical_properties",
"output": {
"count": "int",
"properties": "{name: {volume_cm3, mass_kg, density, area_cm2, center_of_mass}}",
"success": "bool"
},
"statusVerb": null,
"summary": "Per-component physical properties (volume cm3, mass kg, density, area, center of mass) for the active design. Reads them directly so BOM/costing tools no longer have to run getPhysicalProperties inside a modeling script. Pass names to scope to specific components.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"boardId": "required",
"expectDocument": "required exact board name",
"expectedRevision": "required",
"vias": "required [{net, x, y, diameter (mm, default 0.6), drill (mm, default 0.3)}]"
},
"longRunning": false,
"name": "fusion_place_vias",
"output": {
"missing": "list",
"revision": "str",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Add vias at exact points (stitching, thermal, escape): VIA per via with its drill and diameter, then read back.",
"timeoutSeconds": 120
},
{
"example": {
"parts": [
{
"lbrPath": "C:/tmp/al8843.lbr",
"modelPath": "C:/tmp/al8843.step",
"package": "AL8843SP-13"
}
]
},
"input": {
"libraryPath": "optional .lbr for context",
"parts": "optional [{package, lbrPath, modelPath}] - the parts you intend to import (drives the estimate)",
"stepPath": "optional single .step when not passing parts[]"
},
"longRunning": true,
"name": "fusion_plan_library_import",
"output": {
"estimatedSec": "float",
"estimatedSecIfAlreadyOpen": "float",
"fusion": "{installed, running, addinReady, status, message}",
"plan": "[{stage, label, estimatedSec, confidence, needsUserConsent?}]",
"success": "bool",
"summary": "str"
},
"statusVerb": null,
"summary": "PRE-FLIGHT for a library import: does NO work and changes nothing. Reports whether Fusion is installed, running, or needs its add-in loaded (with a plain-language message you can show the user), plus a per-stage plan with MEASURED per-machine time estimates scaled to the number of parts you are sending - a multi-part library does one STEP import per part, which is the slowest stage, so the estimate grows with the library. Call this FIRST so the wiki can render the summary and the progress bar's steps, then run the import and poll fusion_prove_result, which reports the SAME stage names.",
"timeoutSeconds": 20
},
{
"example": {},
"input": {
"allowVias": "bool default true",
"boardId": "required str",
"expectDocument": "required str",
"expectedRevision": "required str",
"fromPad": "required str",
"grid": "mm 0.1..5 default 0.5",
"maxNodes": "int 1..100000 default 25000",
"net": "required str",
"timeoutMs": "int 10..5000 default 3000",
"toPad": "required str",
"viaCost": "mm-equivalent cost default 5",
"viaDiameter": "mm default 0.6",
"viaDrill": "mm default 0.3",
"width": "mm default 0.25"
},
"longRunning": false,
"name": "fusion_plan_route",
"output": {
"mutated": "false",
"plan": "{items,route,planner}",
"revision": "str",
"success": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Calculate a read-only, bounded orthogonal A* path between two pads on a live two-layer board. Uses existing copper and the shared conservative clearance model. Returns explicit route args for route_net; native DRC is still required after mutation.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"boardId": "optional",
"expectDocument": "required exact board name"
},
"longRunning": false,
"name": "fusion_pour_state",
"output": {
"filledAreaByLayerMm2": "{layer:mm2}",
"filledAreaByNetMm2": "{net:mm2}",
"pours": "list",
"revision": "str",
"unfilled": "[net]"
},
"statusVerb": "fusion_routing_state",
"summary": "Read every pour on the live board with Fusion's own computed fill: filled area per pour, per layer and per net, and which pours were never filled (no RATSNEST since they were drawn). The measure step of the AI flow's Fusion lane.",
"timeoutSeconds": 60
},
{
"example": {
"libraryPath": "C:/Temp/PART.lbr"
},
"input": {
"libraryPath": "str (Windows .lbr path)"
},
"longRunning": true,
"name": "fusion_preflight_lbr",
"output": {
"preflight": "{ok, checks[], errors[]}",
"success": "bool"
},
"statusVerb": null,
"summary": "PRE-ANALYZE a .lbr: will Fusion open it? Offline and instant - no Fusion needed, nothing launched. Runs the named checks the bridge learned from real Fusion rejections: file-readable, size-sane (truncated-transfer corpse detection), xml-parses, root-is-eagle, packages-nonempty (Fusion's silent 'No Components'), symbols-present, devicesets-present (missing ones make EDIT raise Create-new prompts), connects-resolve (dead wiring renders fine and connects nothing). fusion_open_lbr and fusion_create_library run the same gate automatically; call this directly to gate a batch BEFORE staging.",
"timeoutSeconds": 10
},
{
"example": {
"save": true
},
"input": {
"save": "optional bool, default true"
},
"longRunning": false,
"name": "fusion_prefs_close",
"output": {
"closed": "bool",
"saved": "bool"
},
"statusVerb": "fusion_get_preferences",
"summary": "Apply+OK (save:true, the default) or Cancel Fusion's Preferences dialog. Settings changed via fusion_prefs_open are NOT persisted until this is called with save:true.",
"timeoutSeconds": 60
},
{
"example": {
"section": "api"
},
"input": {
"section": "optional str (see knownSections in the response)"
},
"longRunning": true,
"name": "fusion_prefs_open",
"output": {
"hwnd": "int",
"knownSections": "[str]",
"screenshot": "str",
"shotId": "str",
"steps": "list"
},
"statusVerb": "fusion_get_preferences",
"summary": "Open Fusion's Preferences dialog and optionally jump to a section, then hand back a SCREENSHOT + shotId you can click in. This is how you reach ANY Fusion preference: the Python API exposes only a thin slice (theme/orbit/units, debuggingPort, developer tools) and everything else, including the MCP server toggle, is UI-only. Sections: general, api, design, manufacture, electronics, render, drawing, material, graphics, network, preview features. Child sections under General are lazily rendered by Qt and never appear in the UIA tree, which is why this returns an image to click rather than control names. ALWAYS finish with fusion_prefs_close {save:true} - nothing is saved otherwise, and killing/restarting Fusion first discards the change.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_prewarm",
"output": {
"fusionInstalled": "bool",
"fusionStarted": "bool (always false)",
"ok": "bool",
"steps": "[{step, ok, ...}]"
},
"statusVerb": null,
"summary": "Warm the bridge ahead of the first real call, WITHOUT starting Fusion: confirms the add-in is synced into every Fusion add-in folder, readies the space-free staging folder, and caches the PCB design-rules catalog from adom/pcb-design-rules. Adom Bridge calls it once per installed version in the background (bridge.json prewarm.verb); safe to call again any time. Launching Fusion is never part of it.",
"timeoutSeconds": 120
},
{
"example": {
"runId": "a3f1c2d4e5b6"
},
"input": {
"inlineFrames": "optional bool",
"runId": "optional str (omit for the latest run)",
"shots": "optional int",
"sinceShot": "optional int"
},
"longRunning": true,
"name": "fusion_prove_result",
"output": {
"etaSec": "float",
"evidence": "[]",
"percent": "float",
"stage": "str",
"verdict": "str"
},
"statusVerb": null,
"summary": "POLL a background run started by fusion_create_library or the detached fusion_build_library_3d. Returns stage + stageLabel, plan[] with measured per-stage estimates, stagesDone, percent, etaSec, confidence, and evidence[] filling in AS EACH ARTIFACT LANDS (symbol -> footprint -> 3d -> ganged). For a 3D build it carries per-part progress (minting X (3/7)), partsDone/partsTotal and parts[] with each wip_urn. stage:done only means the chain FINISHED - the top-level verdict (proven/not_proven) is the score, and a run that captured zero frames lands stage:failed with blocked_by_dialog (carrying the dialog text) or no_evidence_captured rather than reporting done. Pass inlineFrames:true on the final fetch for base64 thumbnails a browser can render. restarts[] {at, why, kind} lists any restart the chain performed (only with allowRestart). prove.planned / prove.skipped say whether evidence frames were captured and why (AI threads bind only by default).",
"timeoutSeconds": 20
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_readiness",
"output": {
"bridgeVersion": "str",
"hostApp": "str",
"installed": "bool",
"ready": "bool",
"running": "bool"
},
"statusVerb": null,
"summary": "FAST readiness check (does NOT launch Fusion): is the Fusion host app installed + running + the bridge ready to drive? ab DETECTS Fusion (never installs it) via bridge.json 'detect', and auto-installs Python if missing (ab >=1.9.47). Call this before driving Fusion; if installed-but-not-running, fusion_start. SELF-HEALS the seat/licensing dialog (background UIA + screenshot-verify) whenever it detects one. Pairs with ab's bridge_readiness.",
"timeoutSeconds": 15
},
{
"example": {},
"input": {
"save": "optional bool (default false): save open documents before closing"
},
"longRunning": false,
"name": "fusion_release_seat",
"output": {
"released": "bool",
"success": "bool",
"wasHeldBy": "obj"
},
"statusVerb": null,
"summary": "Give up the Autodesk seat from THIS machine so another box can claim it with no modal at all: closes Fusion cleanly (documents are NOT discarded; an unsaved one refuses and says so) and leaves the account signed in, so this box can claim the seat straight back. The counterpart of fusion_claim_seat.",
"timeoutSeconds": 180
},
{
"example": {},
"input": {
"boardId": "required",
"expectDocument": "required exact board name",
"expectedRevision": "required",
"pours": "optional 'all' (default) or [{net, layer, points}]"
},
"longRunning": false,
"name": "fusion_remove_pours",
"output": {
"left": "list",
"removed": "int",
"revision": "str",
"success": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Delete pours (all of them, or the ones named by net, layer and outline) so a board can be poured again after a refine. Each DELETE picks the outline point farthest from every pad (refused if none is 1 mm clear), and the readback undoes everything if a part or a track changed.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"force": "optional bool default false - also discard MODIFIED Untitled docs"
},
"longRunning": false,
"name": "fusion_reset_workspace",
"output": {
"closedByAddin": "list",
"remaining": "list",
"success": "bool",
"untitledScratchClosed": "int"
},
"statusVerb": null,
"summary": "Bring Fusion back to a clean slate between runs: closes named documents AND the Untitled scratch the library/bind flow leaves behind (page issue #59). Fusion always keeps ONE blank document alive, so a single remaining Untitled is correct rather than a failure. MODIFIED Untitled docs are left untouched unless force:true, because those can hold real unsaved work.",
"timeoutSeconds": 90
},
{
"example": {},
"input": {
"maxClicks": "optional int (default 3)"
},
"longRunning": false,
"name": "fusion_resolve_seat_dialog",
"output": {
"clicks": "int",
"resolved": "bool"
},
"statusVerb": null,
"summary": "Readiness EXECUTOR (Rust port, Phase 3): detect + resolve the Autodesk seat/licensing modal ('Active Sessions Exceeded' / 'Suspend Remote Session') in the background, at most 3 UIA clicks per call, screenshot-verified. Idempotent: nothing up answers clicks:0. fusion_readiness calls this itself when it sees the dialog; call it directly only when you are driving the launch by hand.",
"timeoutSeconds": 60
},
{
"example": {
"save": true
},
"input": {
"save": "optional bool (default true) - save open documents before restarting"
},
"longRunning": false,
"name": "fusion_restart_for_addin",
"output": {
"addinReady": "bool",
"steps": "[{step, ok}]",
"success": "bool",
"tookSec": "float"
},
"statusVerb": null,
"summary": "ASYNC: returns immediately (started:true) and restarts Fusion in the background, SAVING the user's open documents first; poll fusion_readiness until ready with the new addinVersion (a restart takes 60-120s, longer than the relay budget; pass wait:true for the old blocking form). Finish add-in setup by restarting Fusion. Call this when any verb returns errorCode addin_restart_required (the add-in was installed/updated while Fusion was already open, and Fusion only loads add-ins at launch). ASK THE USER FIRST when a human is present - the failing verb's payload carries userMessage plus openDocuments/unsavedDocuments so you can show them what is open. Refuses with unsaved_named_document rather than discarding a never-saved document.",
"timeoutSeconds": 300
},
{
"example": {},
"input": {
"boardId": "required",
"expectDocument": "required exact board name",
"expectedRevision": "required",
"nets": "required [net name]"
},
"longRunning": false,
"name": "fusion_ripup_nets",
"output": {
"revision": "str",
"ripped": "[net]",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Take whole nets' tracks and vias back up (RIPUP per net, one undo step each) so they can be routed again, wider or another way. Their pours stay. Readback proves no track or via is left on those nets and no pour was lost.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"boardId": "required from routing_state",
"clearance": "mm lower bound, default .2",
"dryRun": "optional bool",
"expectDocument": "required exact board name",
"expectedRevision": "required from routing_state",
"layer": "1 or 16, default 1",
"net": "required exact name",
"paths": "optional list of paths instead of points",
"points": "waypoints [x,y] or {pad} or {x,y,layer}",
"viaDiameter": "mm, default .6",
"viaDrill": "mm, default .3",
"width": "mm, default .25"
},
"longRunning": false,
"name": "fusion_route_net",
"output": {
"mutated": "bool",
"plan": "obj",
"remainingNets": "list",
"revision": "str",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_routing_state",
"summary": "Create explicit net copper in the live Fusion canvas. Conservative clearance preflight, board/revision guards and exact copper readback. One or several trace segments per call; no general autorouting. Use routing_drc for native DRC.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"boardId": "required",
"expectDocument": "required exact board name",
"expectedRevision": "required"
},
"longRunning": false,
"name": "fusion_routing_drc",
"output": {
"drc": "{checked,clean,errorCount,warningCount,airwireCount,errors}",
"revision": "str"
},
"statusVerb": "fusion_routing_state",
"summary": "Run fresh native Autodesk DRC and read UL_BOARD.errors, including approved errors, warnings and airwires. Does not accept or clear any violation.",
"timeoutSeconds": 120
},
{
"example": {
"expectDocument": "fusion-routing"
},
"input": {
"boardId": "optional document creationId guard",
"expectDocument": "required exact active board name"
},
"longRunning": false,
"name": "fusion_routing_state",
"output": {
"boardId": "str",
"nets": "list",
"pads": "list",
"remainingNets": "list",
"revision": "str",
"segments": "list",
"vias": "list"
},
"statusVerb": "fusion_routing_state",
"summary": "Read the live board's identity, geometry revision, pads, copper and per-net airwires from a fresh Fusion export.",
"timeoutSeconds": 60
},
{
"example": {
"script": "import adsk.fusion\n# ...build geometry..."
},
"input": {
"script": "required str (Python using adsk; globals: adsk, app, ui, design)"
},
"longRunning": true,
"name": "fusion_run_modeling_script",
"output": {
"documentName": "str",
"result": "obj"
},
"statusVerb": null,
"summary": "Run an adsk.fusion modeling script in the live session (sketches/extrudes/params). Free programmatic CAD.",
"timeoutSeconds": 180
},
{
"example": {
"name": "TJA1050",
"projectName": "Main"
},
"input": {
"description": "optional str",
"folderPath": "optional str",
"name": "required str",
"projectName": "optional str"
},
"longRunning": false,
"name": "fusion_save_to_cloud",
"output": {
"success": "bool",
"urn": "str"
},
"statusVerb": null,
"summary": "Save the ACTIVE document to Autodesk cloud storage with an explicit name and destination. Dialog-free precisely because you supply what the Save box would ask for - use it before closing or restarting when a document has never been saved (fusion_close_all_documents refuses such a document with unsaved_named_document rather than discarding it).",
"timeoutSeconds": 180
},
{
"example": {
"action": "open",
"fileName": "BQ25792 Assembly",
"projectName": "Main"
},
"input": {
"action": "required str: open | create | show",
"brdPath": "optional local .brd (open; defaults to the sibling)",
"capture": "optional bool: inline screenshot proof after the switch",
"fileName": "cloud design name (open)",
"filePath": "local .fsch (open)",
"name": "optional str (create)",
"projectName": "optional str (open, with fileName)",
"query": "find-and-open by name (open)",
"schPath": "local EAGLE .sch on the Fusion machine (open)",
"urn": "cloud lineage urn (open)",
"withBoard": "optional bool (open; false = schematic only, dialog-free)"
},
"longRunning": true,
"name": "fusion_schematic",
"output": {
"documentName": "str (create)",
"schPath": "str (create)",
"success": "bool",
"via": "str: the verb that did the work"
},
"statusVerb": "fusion_get_app_state",
"summary": "START HERE for a schematic. ONE verb, three actions. action:\"open\" lands in the schematic editor from whatever names the design: fileName (+projectName) or urn or query for a CLOUD design (opens it, then switches to the schematic view), schPath for a local EAGLE .sch (its sibling .brd is imported with it so parts instantiate, unless withBoard:false; a .sch alone opens dialog-free), or filePath for a Fusion-native .fsch. action:\"create\" writes a blank EAGLE schematic on the box and opens it as a NEW local electronics design with the schematic editor active, no dialog anywhere. action:\"show\" switches the already-open design to its schematic view. Every reply says which underlying verb it used (via). Remember: a schematic is a VIEW of an electronics design, not a file of its own, which is why there is no verb called open_a_schematic_file. To put a library's parts on a NEW schematic and board for showing them off, use fusion_make_showcase_project instead.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {
"columns": "optional frames per row (default 3)",
"libraryPath": "required .lbr on this machine",
"nets": "required {net:[ref.pin or ref.pad]}",
"parts": "required [{ref, deviceset, value?, block?}]"
},
"longRunning": false,
"name": "fusion_schematic_plan",
"output": {
"commandCount": "int",
"groups": "[{group, parts, commands}]",
"notInParts": "[str]"
},
"statusVerb": "fusion_get_app_state",
"summary": "Plan a grouped schematic from a netlist: one labelled frame per block, the block's parts in a row, every connected pin given a short stub named for its net and a label. Returns the command groups for fusion_schematic_run (one call per group, so the sheet grows block by block on camera). Pins may be named by pad (U1.3) or pin (U1.VIN). Pure computation from the .lbr; nothing in Fusion changes.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"commands": "required [command] (1..400)",
"expectDocument": "optional exact schematic name",
"libraryPath": "required for ADD: the .lbr on this machine (its file name is the library name in ADD)",
"pauseMs": "optional 0..3000 between commands"
},
"longRunning": false,
"name": "fusion_schematic_run",
"output": {
"added": "[name]",
"commands": "int",
"nets": "{net:[part.pin]}",
"parts": "[name]",
"success": "bool",
"verified": "bool"
},
"statusVerb": "fusion_get_app_state",
"summary": "Build a schematic live: a list of complete, non-interactive EAGLE commands run one at a time on the active schematic (ADD 'dev@lib' 'NAME' R0 (x y), VALUE, NET 'name' (pts), LABEL, WIRE, TEXT, LAYER, CHANGE STYLE/SIZE/WIDTH/RATIO, WINDOW FIT), with an optional pause between them so a viewer sees it grow. Anything else is refused before the first command runs. ADD is proven against libraryPath on disk first (the deviceset must be there; the library is USEd by the bridge), so the component picker can never open. Readback: the parts and nets on the sheet from a fresh export.",
"timeoutSeconds": 120
},
{
"example": {},
"input": {
"hwnd": "optional int (a dialog; default the main window)"
},
"longRunning": false,
"name": "fusion_screenshot_fusion",
"output": {
"fullPath": "str (auto-pulled by ab, 1.10.37)",
"safePath": "str",
"savedTo": "str",
"sizeKB": "int",
"success": "bool"
},
"statusVerb": null,
"summary": "Background PrintWindow capture of Fusion's MAIN window (largest same-title window; works occluded/bottom-of-z-order, never raises anything) or a specific dialog by hwnd. Returns fullPath/safePath (ab auto-pulls them to the caller as localPath, 1.10.37) plus the older savedTo. (Live since early versions but undescribed until 2026-08-15 - it was invisible to callers AND to the drift check.)",
"timeoutSeconds": 60
},
{
"example": {
"query": "Molecule"
},
"input": {
"query": "required str"
},
"longRunning": false,
"name": "fusion_search_cloud_files",
"output": {
"disabled": "bool"
},
"statusVerb": null,
"summary": "\u26d4 DISABLED (returns an error): the in-app add-in search took 30+ min and CRASHED Fusion (WinError 10054). It is hard-blocked in the bridge. Use fusion_aps_search {query} \u2014 server-indexed, seconds, no Fusion. See the 'fusion-aps-search' skill.",
"timeoutSeconds": 15
},
{
"example": {
"enabled": true
},
"input": {
"enabled": "optional bool (omit to read current value)"
},
"longRunning": true,
"name": "fusion_set_auto_update",
"output": {
"autoUpdateFusion": "bool",
"narrate": "str"
},
"statusVerb": "fusion_readiness",
"summary": "Turn AUTOMATIC Fusion updating on/off for this user. ON BY DEFAULT, and deliberately INVISIBLE: Fusion ships updates constantly and nags with an 'Update Now / Update Later' panel plus a '14 days until Fusion must update' countdown. Every fusion_readiness call checks for that offer and, if present, the bridge clicks it IN THE BACKGROUND (UIA, no foreground, no caption) so the download starts and the newer build comes up on the next launch. The user should never have to click it. Call with no args to read the current setting; {enabled:false} opts out and the choice is STICKY (~/.adom/fusion-bridge/prefs.json) - once a user opts out, NEVER click their update prompts again. Tell the user this is handled for them rather than asking them to update.",
"timeoutSeconds": 30
},
{
"example": {
"fab": "jlcpcb",
"layers": "2"
},
"input": {
"action": "optional str (apply|list|export|show)",
"druBase64": "optional str: the same, base64-encoded",
"druName": "optional str: file name for the staged copy",
"druPath": "optional str .edru/.dru ALREADY on the Fusion machine, loaded as-is",
"druText": "optional str: the whole .edru/.dru file as text, for rules that exist only on YOUR side (a container). The bridge stages it on the box and loads it (1.10.37; replaces ab's removed fusion_load_design_rules)",
"fab": "optional str vendorSlug (jlcpcb|pcbway|osh-park|seeed-fusion|eurocircuits|aisler|elecrow|advanced-circuits-4pcb|sierra-circuits|macrofab|nextpcb|allpcb|adom-3rdpartyfab)",
"layers": "optional str (auto|2|4|6)",
"process": "optional str (the vendor's tier: standard|advanced|proto|enig|hasl|...; default standard)"
},
"longRunning": false,
"name": "fusion_set_design_rules",
"output": {
"activeWorkspace": "str",
"description": "str",
"pack": "dict {fab, vendor, process, layers, file, record}"
},
"statusVerb": null,
"summary": "Load a FAB's design rules (DRC) into the open board. The rule packs live on the wiki page adom/pcb-design-rules (JLCPCB, PCBWay, OSH Park, Seeed, Eurocircuits, Aisler, Elecrow, Advanced Circuits, Sierra, MacroFab, NextPCB, ALLPCB and 3rd party fab; one .edru per vendor/process/layer count, every number citing the vendor's own capabilities page): the bridge fetches the pack, stages it on the box, and the add-in runs `drc load`. {action:'list'} answers with every (fab, process, layers) row so you can offer the user a real choice; no fab means the bundled 3rd party fab rules for the board's layer count (what ab's removed fusion_apply_3rdpartyfab_rules did); druPath loads an .edru already on the Fusion machine; druText/druBase64 loads one that exists only on your side. Layers auto-detects from the open board. ALWAYS confirm with fusion_alerts afterwards: a refused file is an in-canvas toast, never a dialog.",
"timeoutSeconds": 90
},
{
"example": {},
"input": {
"enabled": "optional bool (omit to read)",
"nativeViewport": "optional bool (default true with screenshot): also export the native viewport frame and count bodies; the reply carries nativeViewport {path, ok, bodies, productType}, geometry {bodies} (API truth, independent of pixels) and windowPixels {dominantColorFraction, blank} for the window capture. A blank window capture of a Design viewport is a known WGC artefact: trust nativeViewport, never foreground Fusion for a capture (issue #84)",
"viewport": "optional str: \"native\" = only the frame Fusion itself renders (activeViewport.saveAsImageFile through the add-in), no window capture"
},
"longRunning": false,
"name": "fusion_set_driving_badge",
"output": {
"showDrivingBadge": "bool",
"success": "bool"
},
"statusVerb": "fusion_state",
"summary": "Read/toggle the 'Adom is driving Fusion' TASKBAR OVERLAY BADGE (STICKY per user, default ON). While the bridge drives Fusion, its Windows taskbar button wears a small Adom mark so the user knows at a glance who is in control; it sheds automatically after 5 minutes of driving-verb idle. No args = read. Turning it off clears any badge immediately.",
"timeoutSeconds": 15
},
{
"example": {
"expression": "1.6 mm",
"name": "board_thickness"
},
"input": {
"expression": "required str (new expression, e.g. \"10 mm\")",
"name": "required str (parameter name as listed by fusion_get_parameters)"
},
"longRunning": false,
"name": "fusion_set_parameter",
"output": {
"expression": "str",
"name": "str",
"success": "bool",
"unit": "str",
"value": "float (internal units)"
},
"statusVerb": null,
"summary": "Set one parameter's expression by name in the ACTIVE 3D Design document (user parameters first, then model parameters). MUTATES the design: the model regenerates and the result carries the post-op dialog array. Requires a Design document to be active (a 2D board or library editor refuses). Read names and current expressions with fusion_get_parameters; units must match the parameter (\"10 mm\", \"5 deg\").",
"timeoutSeconds": 30
},
{
"example": {
"theme": "dark"
},
"input": {
"cameraPivot": "optional bool",
"gestureNav": "optional bool",
"invertScrollZoom": "optional bool",
"lengthUnit": "optional str",
"modelingOrientation": "optional str",
"orbitScheme": "optional str",
"theme": "optional str"
},
"longRunning": true,
"name": "fusion_set_preference",
"output": {
"applied": "obj",
"current": "obj"
},
"statusVerb": null,
"summary": "Set Fusion appearance/navigation preferences in the LIVE session - applies immediately, NO restart. Keys: theme (light/darkblue/darkgray/classic/device/dark; some builds only ship LightGray/DarkBlue/Device, failures reported per-key), invertScrollZoom (bool - mouse scroll/zoom direction), orbitScheme (fusion360/alias/inventor/solidworks/tinkercad/powermill), modelingOrientation (yup/zup), gestureNav (bool), cameraPivot (bool), lengthUnit (mm/cm/m/in/ft - active design). Per-key outcome in `applied`, resulting state in `current`.",
"timeoutSeconds": 30
},
{
"example": {},
"input": {
"enabled": "optional bool (omit to read)"
},
"longRunning": false,
"name": "fusion_set_seat_takeover",
"output": {
"autoTakeOverSeat": "bool",
"success": "bool"
},
"statusVerb": "fusion_readiness",
"summary": "Read/toggle the mid-session Autodesk seat-takeover sweep (STICKY per user, default ON). When Autodesk pops 'Active Sessions Exceeded' mid-session, the bridge clicks Continue through BOTH dialogs in the background: this machine takes the seat, the other machine's Fusion suspends RESUMABLY, the user gets one toast. No args = read current value. Gates only the passive sweep - a verb-driven fusion_start still grabs the seat (the user asked for Fusion, so the seat is implied).",
"timeoutSeconds": 15
},
{
"example": {},
"input": {
"enabled": "optional bool (omit to read)"
},
"longRunning": false,
"name": "fusion_set_window_sizing",
"output": {
"sizeFusionWindow": "bool",
"success": "bool"
},
"statusVerb": "fusion_state",
"summary": "Read/toggle auto-sizing Fusion's WINDOW after launch (STICKY, default ON). Fusion opens at whatever geometry it last had, which after an automated launch is often a small default; the bridge grows it to ~92% of the monitor work area, centered, using SetWindowPos with NOACTIVATE (never ShowWindow/maximize) so focus is never stolen. A window the user maximized, or already sized to >=60% of the work area, is left alone. No args = read.",
"timeoutSeconds": 15
},
{
"example": {},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"documentName": "optional str - the open document to show; the bridge activates it first (1.10.28). Pass it whenever more than one tab is open (a board plus its library is the usual pair); without it the verb acts on the ACTIVE document and answers not_an_electronics_design with openDocuments when a library or 3D design is in front"
},
"longRunning": true,
"name": "fusion_show_2d_board",
"output": {
"activeWorkspace": "str"
},
"statusVerb": null,
"summary": "Switch the OPEN electronics design to its 2D PCB Editor (board layout) view. This is a VIEW of the project, not a file to open standalone - if the board is empty, you opened a child/derivative instead of the EcadDesignProductType PROJECT; reopen the project. Drive the view with fusion_electron_run WINDOW commands.",
"timeoutSeconds": 70
},
{
"example": {},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"documentName": "optional str - the open document to show; the bridge activates it first (1.10.28). Pass it whenever more than one tab is open (a board plus its library is the usual pair); without it the verb acts on the ACTIVE document and answers not_an_electronics_design with openDocuments when a library or 3D design is in front"
},
"longRunning": true,
"name": "fusion_show_3d_board",
"output": {
"activeWorkspace": "str",
"screenshots": "[...]"
},
"statusVerb": null,
"summary": "Switch the OPEN electronics design to its 3D PCB view (populated board). A VIEW of the project, not a standalone file. Orbit it for demos via fusion_run_modeling_script (app.activeViewport.camera + vp.refresh()).",
"timeoutSeconds": 70
},
{
"example": {
"name": "MYCHIP",
"stepPath": "C:/Temp/chip.step"
},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"foreground": "optional bool - DEFAULT IS BACKGROUND (no focus steal; response carries windowEtiquette:background). true REQUIRES foregroundReason and shows it to the user as a 3s ab caption before any focus change - only when the USER asked to watch",
"foregroundReason": "required WITH foreground:true - a short user-facing sentence shown as the 3s caption (e.g. 'You asked to watch the 3D board build')",
"libraryPath": "optional str (.lbr)",
"name": "str",
"packageXml": "optional str (bare <package> fragment)",
"stepPath": "optional str (WINDOWS path .step to attach)"
},
"longRunning": true,
"name": "fusion_show_3d_package",
"output": {
"screenshot": "str path",
"success": "bool",
"view": "str",
"wrappedLibrary": "str"
},
"statusVerb": null,
"summary": "Open the 3D CHIP view (Package3DEnvironment) for a library package - and the RELIABLE way to get a 3D model into a library: pass stepPath and it is attached AFTER the library opens (embedded <packages3d> in hand-built .lbr files is the Fusion quirk that fails; attach-after-open works). stepPath with no library/packageXml auto-generates a minimal 2-pad carrier footprint. Without stepPath it just enters the 3D view of the named package.",
"timeoutSeconds": 300
},
{
"example": {
"deviceset": "VL53L8CX",
"libraryPath": "C:/Users/me/Downloads/Adom_ToF.lbr"
},
"input": {
"capture": "optional bool (default true)",
"deviceset": "required str",
"dialog": "optional bool (default true): open, read, capture and close Fusion's Variant Attributes table",
"libraryPath": "optional str (.lbr on the Fusion machine; opened first and read for the attributes; omit when the library is already the active document)"
},
"longRunning": false,
"name": "fusion_show_attributes",
"output": {
"attributes": "obj (the component's metadata)",
"screenshot": "str|null (device editor)",
"success": "bool",
"variantAttributesDialog": "{opened, closed, title, text, screenshot}"
},
"statusVerb": "fusion_get_app_state",
"summary": "Show a component's METADATA, as data and on screen. Returns the attributes of a deviceset (MPN, MANUFACTURER, MOUSER_PN, DIGIKEY_PN, LCSC_PN, DATASHEET, ADOM_WIKI, per variant) read from the library file with full values, in BOTH dialects: EAGLE <technology><attribute> and Fusion's layered <att_values>/<att_set> (1.10.34; Fusion-authored libraries used to read as empty). Opens the DEVICE editor (EDIT <name>.dev: symbol, Packages table with the Mapped check, footprint and 3D previews) with a capture, then opens Fusion's own Variant Attributes table with EAGLE's ATTRIBUTE command (no positioned clicks), reads it through UI Automation, captures the dialog window and Cancels it. Nothing is left on screen. dialog:false skips the table.",
"timeoutSeconds": 120
},
{
"example": {
"libraryPath": "C:/Temp/lib.lbr",
"name": "ADS8588SIPM"
},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"foreground": "optional bool - DEFAULT IS BACKGROUND (no focus steal; response carries windowEtiquette:background). true REQUIRES foregroundReason and shows it to the user as a 3s ab caption before any focus change - only when the USER asked to watch",
"foregroundReason": "required WITH foreground:true - a short user-facing sentence shown as the 3s caption (e.g. 'You asked to watch the 3D board build')",
"libraryPath": "optional str",
"name": "str",
"packageXml": "optional str (bare <package ...>...</package>)"
},
"longRunning": true,
"name": "fusion_show_footprint",
"output": {
"screenshot": "str path",
"success": "bool",
"view": "str",
"wrappedLibrary": "str (when wrapped)"
},
"statusVerb": null,
"summary": "Open a FOOTPRINT (package) in Fusion's library editor. Same contract as fusion_show_symbol: name + libraryPath, or a bare <package> fragment as packageXml (wrapper library generated).",
"timeoutSeconds": 180
},
{
"example": {
"libraryPath": "C:/Temp/PART.lbr"
},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"libraryPath": "optional str (WINDOWS .lbr)",
"name": "optional str (already-open library name)"
},
"longRunning": true,
"name": "fusion_show_library",
"output": {
"screenshot": "str",
"success": "bool",
"view": "str"
},
"statusVerb": null,
"summary": "Eight-surfaces contract: the LIBRARY surface. libraryPath (WINDOWS .lbr) opens it; name alone handles the already-open case (symmetric with kicad_show_library). Background; returns a screenshot path.",
"timeoutSeconds": 240
},
{
"example": {
"query": "BQ25792"
},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"fileName": "alias of query",
"query": "optional str (cloud design name)",
"urn": "optional str"
},
"longRunning": true,
"name": "fusion_show_project",
"output": {
"document": "str",
"screenshot": "str",
"success": "bool",
"view": "str"
},
"statusVerb": "fusion_get_app_state",
"summary": "Eight-surfaces contract: bring the PROJECT/design to its top level. No args = activate this session's generated test project (fusion_make_test_project). query = cloud design name (already-open match wins, else fire-and-poll open). urn = open_by_urn passthrough. Background; returns a screenshot path.",
"timeoutSeconds": 240
},
{
"example": {},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"documentName": "optional str - the open document to show; the bridge activates it first (1.10.28). Pass it whenever more than one tab is open (a board plus its library is the usual pair); without it the verb acts on the ACTIVE document and answers not_an_electronics_design with openDocuments when a library or 3D design is in front"
},
"longRunning": true,
"name": "fusion_show_schematic",
"output": {
"activeWorkspace": "str",
"productType": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Switch the OPEN electronics design to its SCHEMATIC view (the symmetric partner of fusion_show_2d_board / fusion_show_3d_board, via Fusion's SwitchSchDocCmd). A VIEW of the project, not a standalone file. Drive it for demos with fusion_electron_zoom / _pan / _select.",
"timeoutSeconds": 70
},
{
"example": {
"libraryPath": "C:/Temp/lib.lbr",
"name": "ADS8588SIPM"
},
"input": {
"capture": "optional bool - ONE call = ONE consent: the bridge settles the surface (waits for the add-in main thread + a paint beat) and returns proof inline as shot:{title,image,thumbnailDataUrl,maxWidth} (base64 frame + a ready-to-use data: URL for BROWSER callers who cannot pull a file; set captureMaxWidth to shrink it - 320 keeps a /command body small, default 640. The bridge encodes PNG; the relay may transcode to WebP, so sniff rather than assume). Use this instead of polling fusion_state after a show - page-side settle polling costs one human consent per poll (issue #30).",
"foreground": "optional bool - DEFAULT IS BACKGROUND (no focus steal; response carries windowEtiquette:background). true REQUIRES foregroundReason and shows it to the user as a 3s ab caption before any focus change - only when the USER asked to watch",
"foregroundReason": "required WITH foreground:true - a short user-facing sentence shown as the 3s caption (e.g. 'You asked to watch the 3D board build')",
"libraryPath": "optional str (WINDOWS path .lbr)",
"name": "str (deviceset/symbol name; optional if symbolXml carries name=)",
"symbolXml": "optional str (bare <symbol ...>...</symbol>)"
},
"longRunning": true,
"name": "fusion_show_symbol",
"output": {
"screenshot": "str path",
"success": "bool",
"view": "str",
"wrappedLibrary": "str (when wrapped)"
},
"statusVerb": null,
"summary": "Open a schematic SYMBOL in Fusion's library editor - first-class, no hand-built EDIT strings. Pass name + libraryPath (.lbr, opened first; omit libraryPath if a library is already open), OR pass a BARE <symbol> XML fragment as symbolXml and the bridge generates a minimal wrapper library around it (deviceset + gate synthesized) so it shows in the Library Manager. Background-safe: never steals the foreground.",
"timeoutSeconds": 180
},
{
"example": {},
"input": {
"account": "optional str email: which account to pick in a provider chooser (e.g. the Google account list); remembered with the method",
"auto": "optional bool (do click+capture+reopen in one on-box call - recommended)",
"method": "optional str google|apple|microsoft|facebook|password (1.11.1): HOW this Autodesk account signs in. With it the bridge drives the sign-in page itself (clicks the provider, picks the account, clicks Open Product) and REMEMBERS it, so later calls need nothing. Without one and none remembered, the reply is stage method_required with methods[]: ASK THE USER, never guess",
"profile": "optional str (chrome:<email>/edge:<email> - the profile your Autodesk account is in; remembered)",
"waitSec": "optional int (server-side poll budget for the fresh URL, default 32)"
},
"longRunning": true,
"name": "fusion_signin",
"output": {
"done": "bool",
"narrate": "str",
"notifyDelivered": "bool",
"signinAuthUrl": "str",
"signinOpenedVia": "str (extension|extension_free)",
"signinProfile": "str",
"signinProfileReason": "str",
"signinWall": "str|null (twofactor_email_code|credentials|protocol_handoff)",
"signinWallHint": "str|null",
"signinWhere": "str",
"signinWrongBrowser": "str",
"stage": "str"
},
"statusVerb": "fusion_signin",
"summary": "SELF-DRIVING as of 1.9.32: launches Fusion if needed, clicks Sign In, opens the OAuth in the right profile, TYPES THE EMAIL and advances to the exact remaining wall (password/2FA/handoff), toasting the user at that step only - see signinWall + _hint in the response, and the fusion-autodesk-signin skill. Sign Fusion in through the CORRECT browser profile - the fix for Fusion's dumb OAuth that fires at the OS-DEFAULT browser and lands in the wrong Autodesk account. Fusion opens its sign-in in whatever browser is default (e.g. a personal Chrome), but a user's Autodesk seat often lives in a different profile (work). This verb reads the FULL authorize URL (client_id/PKCE/state/request_id) that Fusion wrote into that wrong browser's HISTORY and re-opens it in the RIGHT profile IN THE BACKGROUND; the URL completes back to the running Fusion via the idmgr/callback + autodesk:// handoff, so the browser no longer has to be the OS default. Pass {profile:'chrome:[email protected]'} to fix + remember your Autodesk profile; else it probes each profile for a live Autodesk session (or asks). Staged: if Fusion hasn't opened the browser yet it returns stage:'click_signin' so you click Fusion's Sign In first. BEST: pass {auto:true} to run the WHOLE chain in ONE server-side call - it clicks Fusion's Sign In, polls the browser history on-box for the fresh authorize URL, and re-opens it in the target profile, all without extra remote round-trips, so it fits inside Fusion's ~2-min OAuth request expiry even on a slow/flaky relay (the manual staged path is the fallback). Fusion's request EXPIRES in ~2 min, so a stale captured URL returns stage:'stale' - restart Fusion (fusion_stop/start) for a fresh request and retry auto PROMPTLY. See the 'fusion-multiprofile-signin' skill.",
"timeoutSeconds": 120
},
{
"example": {
"code": "123456"
},
"input": {
"code": "required str (the 6 digits; non-digits are stripped)",
"hwnd": "optional int (the 2FA window; auto-detected)"
},
"longRunning": true,
"name": "fusion_signin_2fa",
"output": {
"narrate": "str",
"steps": "list",
"submitted": "bool"
},
"statusVerb": "fusion_readiness",
"summary": "Submit Autodesk's emailed 6-DIGIT verification code to finish a Fusion sign-in, typed IN THE BACKGROUND (UIA SetValue + Invoke - never steals the user's foreground or moves their cursor). Exists so you can finish a login END TO END for the user instead of parking them on a 2FA screen: if `adom-google` is available in your container, read the code out of their Gmail (`adom-google gmail search 'from:autodesk verification code' --limit 1`), pull the 6 digits, and call this. If adom-google is NOT installed, tell the user that installing it would let you automate logins like this, then let them type it. NEVER ask the user for a code you could read yourself. The bridge ALSO toasts the user's desktop whenever it hits a human wall, so you do not need to ask it to.",
"timeoutSeconds": 90
},
{
"example": {},
"input": {
"allowRestart": "optional bool (default false). The chain NEVER relaunches Fusion or restarts the add-in on its own: when the add-in does not answer it surfaces addin_restart_required and waits (resumable). allowRestart:true with restartReason lets it restart, recorded in restarts[] on fusion_prove_result (issue #87)",
"prove": "optional bool. Default from the CALLER: an AI thread (caller headers set) binds and places only; web control / anonymous callers prove (four evidence frames per part, about 300 s per library). Explicit true/false always wins. From an AI thread, look at one part later with fusion_capture_library_views {packages} (issue #88)",
"restartReason": "optional str shown to the human when allowRestart is used"
},
"longRunning": true,
"name": "fusion_start",
"output": {
"addinReady": "bool",
"status": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Launch Fusion 360 (if needed) and wait for the AdomBridge add-in to be ready.",
"timeoutSeconds": 150
},
{
"example": {},
"input": {
"imageAs": "optional str path|base64 (default path)",
"screenshot": "optional bool (default true)"
},
"longRunning": false,
"name": "fusion_state",
"output": {
"activeDocument": "str",
"blockingDialogs": "list",
"focusEvents": "list - the QUIETNESS AUDIT LOG (SDK canonical): every time this bridge took the user's foreground, or refused a bare foreground:true, as {at, verb, outcome: foreground|refused, reason}. Audit how quiet the bridge actually was instead of trusting that it was.",
"mainThreadBusy": "dict|null",
"running": "bool",
"screenshot": "str path",
"screenshotBase64": "str (imageAs:base64 only)",
"success": "bool",
"timings": "dict - measured launch history on THIS machine (p50/p90 per phase, cold vs warm)"
},
"statusVerb": null,
"summary": "The RENDER-ME verb (kicad_state parity, issues #28/#30): running + window + dialog + busy state PLUS a fresh background screenshot of whatever Fusion is showing - the one verb that makes every background fusion_show_* result visible. SERVER-SIDE ONLY by design: it answers even while the add-in main thread is busy or wedged (activeDocument is best-effort with a short budget and skipped when busy). blockingDialogs carries the CLASSIFIED modal list (cause + resolution). imageAs:base64 inlines the PNG (auto-refused over 4MB - pull the screenshot path via pull_file instead).",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"skipCleanClose": "optional bool"
},
"longRunning": false,
"name": "fusion_stop",
"output": {
"output": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Gracefully STOP Fusion 360: close docs cleanly + WM_CLOSE, then wait. NO force-kill - the clean opposite of fusion_start. If a window will not close it returns failure; use fusion_kill then.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {
"outputPath": "optional str"
},
"longRunning": true,
"name": "fusion_take_screenshot",
"output": {
"fullPath": "str (auto-pulled by ab, 1.10.37)",
"path": "str",
"success": "bool"
},
"statusVerb": null,
"summary": "Screenshot the Fusion window in the BACKGROUND (no focus steal, reads through occlusion). Use it to VERIFY your own work: geometry at the wrong Z, an empty view, or a Placeholder 3D body all render successfully and only a look at the pixels catches them.",
"timeoutSeconds": 60
},
{
"example": {
"dryRun": true
},
"input": {
"cascade": "optional bool (set by ab)",
"dryRun": "optional bool (report the paths, delete nothing)",
"name": "optional str (set by ab)"
},
"longRunning": false,
"name": "fusion_uninstall",
"output": {
"dryRun": "bool",
"failed": "[{path,kind,error}]",
"fusionRunning": "bool",
"removed": "[{path,kind}]",
"skipped": "[{path,kind,why}]",
"success": "bool"
},
"statusVerb": null,
"summary": "CASCADE CLEANUP, called by ab's bridge_uninstall BEFORE this bridge's cache is deleted (ab 2.0.35+). Removes the artifacts this bridge planted OUTSIDE its cache: the Fusion ADD-IN in Autodesk's AddIns directories (all three historical locations), plus this bridge's prefs (~/.adom/fusion-bridge) and APS OAuth tokens (~/.adom/fusion-aps). This matters more here than for most bridges: a stale AdomBridge add-in keeps loading on every Fusion launch and binding its port long after the bridge is gone. Fusion itself is never touched. Pass dryRun:true to see exactly what would be removed. If Fusion is RUNNING it holds the add-in files open, so removal may fail - the response says so and names the remedy.",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": true,
"name": "fusion_verb_times",
"output": {
"stages": "{name: {count, p50, p90}}"
},
"statusVerb": null,
"summary": "This machine MEASURED timings per verb/stage - the same store that paces every progress bar and ETA. Read it to see whether an estimate is measured (this box has run it) or typical (still the seeded literal), and to explain a slow run.",
"timeoutSeconds": 15
},
{
"example": {},
"input": {
"action": "required str",
"degrees": "orbit: float (default 40)",
"dx": "pan: float",
"dy": "pan: float",
"factor": "zoom: float (>1 in)",
"fit": "orientations: optional bool fit after (default true)",
"smooth": "optional bool (default true)",
"space": "optional '3d' (default) | '2d'",
"steps": "2D: frames",
"style": "style: str",
"x1": "2D pan",
"x2": "2D pan",
"y1": "2D pan",
"y2": "2D pan"
},
"longRunning": true,
"name": "fusion_view",
"output": {
"action": "str",
"data": "{result}",
"space": "str"
},
"statusVerb": null,
"summary": "FIRST-CLASS camera motion. 3D (the active Design viewport, through Fusion's own camera): fit | home | iso | top | front | right | back | left | bottom | orbit {degrees} | zoom {factor, >1 zooms in} | pan {dx,dy} | style {shaded|shaded-edges|wireframe|hidden-edges|wireframe-hidden}; smooth transitions by default. 2D (space:'2d', the active schematic, board or library editor, through Fusion's WINDOW commands): fit | zoom {factor, steps} | pan {x1,y1,x2,y2 in board mm}. The guided tour's motion runs through this verb. Verify by capture (desktop_screenshot_window before and after).",
"timeoutSeconds": 60
},
{
"example": {},
"input": {},
"longRunning": false,
"name": "fusion_walk_cloud_tree",
"output": {
"disabled": "bool"
},
"statusVerb": null,
"summary": "\u26d4 DISABLED (returns an error): the in-app add-in walk took 30+ min and CRASHED Fusion (WinError 10054). It is hard-blocked in the bridge. Use fusion_aps_search / fusion_aps_open. See the 'fusion-aps-search' skill.",
"timeoutSeconds": 15
},
{
"example": {
"url": "https://library.io/"
},
"input": {
"provider": "optional str google|password (default google)",
"sessionId": "optional str (default autodesk-web)",
"url": "required str (e.g. https://library.io/)",
"username": "optional str (for the Google account chooser)"
},
"longRunning": true,
"name": "fusion_web_signin",
"output": {
"errorCode": "str?",
"steps": "[...]",
"success": "bool",
"url": "str"
},
"statusVerb": "fusion_get_app_state",
"summary": "Sign a pup browser window into an Autodesk WEB surface (library.io, the hub portal at <hub>.autodesk360.com, Autodesk Account) via Google SSO. Fusion's DESKTOP app being signed in does NOT sign these in - they are separate web sessions. NEVER guesses a credential: a missing password or a 2FA challenge comes back as a typed stop (human_credential_required / second_factor_required / google_sso_unavailable) naming the one-time command the USER runs. The password never passes through this bridge or the AI - it is stored once with ab's credential_set and filled by pup in the background.",
"timeoutSeconds": 240
}
]
}