Commands › › Check Clashes Linked

Check Clashes Linked

writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open. At least one linked model must be loaded. MEP elements must exist in the host model.

After it runs

Result JSON stored in LastQueryResult with clash pairs, overlap bounds, and hostElementIds. Optional XML report written to disk if outputXml path is provided. No model modifications — read-only analysis.

When to use this

Structural vs MEP clash check before coordination meeting.
Identifying where pipes/ducts clash with structural beams or columns.
Generating clash reports for BIM coordination.

Don't use this when

Host-only clashes (use CheckClashesCommand). Resolving clashes automatically. Mechanical vs electrical clashes within host model only.

Inputs

Name	Kind	Type	Required	Default	Description
`linkName`	config	`string`	no	—	Optional link name filter (partial match)
`linkedFilter`	config	`string`	no	—	Linked categories: structural (default), all, or columns,framing,foundation,walls
`hostElementIds`	config	`string`	no	—	Optional JSON array of host element IDs; default all MEP
`useSelectionForHost`	config	`boolean`	no	—	If true and hostElementIds empty, use current selection as host set
`outputXml`	config	`string`	no	—	Optional file path to write clashes XML

Returns

Name	Type	Description
`Result`	`JSON`	success, count, clashes, hostElementIds, message

What you'll see in the chat

on start

Running clash check against linked model...
Checking MEP services against structural links...

thinking

Loading linked model elements...
Filtering structural categories...
Running intersection tests against host MEP...
Compiling clash results...

on success

Found {count} clashes between MEP and linked structural elements.

on failure

Linked clash check failed: {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/check_clashes_linked
Request body schema (from [RestApiParam])
Response schema (from [RestApiResponse])
curl / JS / Python code examples

Keywords & intent patterns

clash linked · structural clash · link vs host · clash detection linked · MEP structural clash
Patterns: clash * linked · structural * clash · check * linked * clash · MEP * structural * clash

Related commands	`CheckClashesCommand` · `SectionBoxAroundClashesCommand`
Pillar

Check Clashes Linked

When to use this

Inputs

Returns

What you'll see in the chat

REST API

Keywords & intent patterns

Related