Commands  ›  Architecture / Underlays  ›  Architecture Import Cad As Reference Underlay For Tracing

Architecture Import Cad As Reference Underlay For Tracing

Architecture / Underlays writes to model Public API · not yet exposed

Coming soon

Before you run this

CAD file (.dwg / .dxf) on disk. Active view chosen for the underlay. CAD Reference workset configured (or auto-created).

After it runs

One CAD ImportInstance placed at the view's origin, locked scale, halftone, isolated to the active view, on the CAD Reference workset; audit entry written.

When to use this

Don't use this when

3D imports (use Link CAD), files used across multiple views (use Link CAD with shared positioning), or working documents that should remain editable as separate files.

Decision flow

1. Read the CAD file path and the active view.
2. Use ImportCAD with view-specific scope so the import lives only on the active view.
3. Apply the project's halftone + halftone tint to the import.
4. Place the import on the "CAD Reference" workset.
5. Lock the scale + position; report the import id and view it lives on.

What you'll see in the chat

on start
I'll import that CAD as a reference underlay on this view now.
thinking
Importing into the active view only and putting it on the CAD Reference workset.
on success
Done — CAD reference imported on {view}. Halftone applied, locked to view only.
on failure
Couldn't import the CAD reference: {error}.

REST API

Not yet exposed

This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:

  • POST /api/v1/commands/architecture_import_cad_as_reference_underlay_for_tracing
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

CAD underlay · reference DWG · tracing underlay · view-only CAD · survey trace

PillarArchitecture / Underlays