Commands › Drainage › Match Height And Fillet

Match Height And Fillet

Drainage writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open. At least two pipes must exist. User must select two valid pipe elements.

After it runs

Source pipe endpoint matches target pipe endpoint elevation. Source pipe extended to meet target. Elbow fitting placed at connection point.

When to use this

Connecting branch drains to main drains.
Joining pipes at different elevations with proper fitting.
Quick pipe connections with automatic elevation matching.

Don't use this when

Not for autonomous AI execution. This command requires interactive Revit UI input (dialogs, picks, or manual confirmation).

Side effects

Moves the source pipe element vertically. Extends the source pipe geometry. Creates a fitting element.

Inputs

Name	Kind	Type	Required	Default	Description
`SourcePipe`	selection	`Pipe`	yes	—	Pipe to move and extend (will be modified) "Select SOURCE pipe (this pipe will be moved and extended)"
`TargetPipe`	selection	`Pipe`	yes	—	Pipe to connect to (stays in place) "Select TARGET pipe (source will connect to this)"

Returns

Name	Type	Description
`CreatedFitting`	`FamilyInstance`	The elbow fitting created

Decision flow

check: document.isOpen → continue
action: promptUserToSelectSourcePipe → getSourcePipe
action: promptUserToSelectTargetPipe → getTargetPipe
check: bothPipesValid → continue, else → error
action: matchElevation → moveSource
action: extendToMeet → extendSource
action: placeFitting → createElbow
resolve: success → complete, else → showError

What you'll see in the chat

on start

Matching pipe elevation and connecting with fitting...
Preparing to match height and place elbow...

thinking

Getting source pipe endpoint...
Getting target pipe endpoint...
Matching elevation and extending pipe...
Placing elbow fitting at junction...

on success

Pipes connected with fitting — elevation matched by {ElevationDelta}.

on failure

Match height and fillet 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/match_height_and_fillet
Request body schema (from [RestApiParam])
Response schema (from [RestApiResponse])
curl / JS / Python code examples

Keywords & intent patterns

match height fillet · connect pipes · join elevation · pipe fitting · match and connect
Patterns: match * height * fillet · connect * pipes · join * elevation

Related commands	`MatchHeightCommand` · `ExtendPipeUpCommand` · `ExtendPipeDownCommand`
Pillar	Drainage

Match Height And Fillet

When to use this

Inputs

Returns

Decision flow

What you'll see in the chat

REST API

Keywords & intent patterns

Related