Commands › Drainage › Extend And Connect Pipes

Extend And Connect Pipes

Drainage writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open. At least one other pipe of the same system must exist within search radius with an unconnected endpoint.

After it runs

Source pipe is extended to meet the target pipe. An elbow fitting connects the two pipes.

When to use this

Connecting branch drains to main horizontal runs.
Connecting horizontal pipes to vertical risers.
Rapid connection during preliminary pipe layout.
Auto-connecting pipes during MEP routing.

Don't use this when

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

Side effects

Modifies source pipe geometry (extends endpoint). Creates a new FamilyInstance (elbow fitting).

Inputs

Name	Kind	Type	Required	Default	Description
`SourcePipe`	selection	`Pipe`	yes	—	Pipe to extend and connect "Select pipe to extend (click near endpoint to connect)"
`SearchRadius`	config	`double`	no	3000.0	Search radius for target pipes (mm)

Returns

Name	Type	Description
`CreatedFitting`	`FamilyInstance`	The elbow fitting created
`ConnectionMade`	`bool`	Whether connection was successful
`XOffset`	`double`	X offset applied in mm
`YOffset`	`double`	Y offset applied in mm
`ZOffset`	`double`	Z offset applied in mm

Decision flow

check: document.isOpen → continue
action: promptUserToSelectPipe → getSourcePipe
check: pipeSelected → continue, else → error
action: getSelectionPoint → determineEndpoint
action: executeExtendAndConnect → processConnection
resolve: success → showSuccess, else → showError

What you'll see in the chat

on start

Extending and auto-connecting pipe to nearest same-system pipe...
Finding nearby pipe to connect to...

thinking

Waiting for pipe selection...
Searching for nearby pipes of the same system within radius...
Calculating extension path to target pipe...
Extending source pipe to match target position...
Creating elbow fitting at junction...

on success

Connected! Extended pipe by X:{XOffset}mm Y:{YOffset}mm Z:{ZOffset}mm with elbow fitting.

on failure

Failed to extend and connect: {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/extend_and_connect_pipes
Request body schema (from [RestApiParam])
Response schema (from [RestApiResponse])
curl / JS / Python code examples

Keywords & intent patterns

extend pipe · connect pipe · auto connect · pipe connection · extend and connect · auto fillet
Patterns: extend * pipe * connect · connect * pipes * together · extend * to * pipe · auto * connect * pipe

Related commands	`ExtendAndConnectManualCommand` · `MEPSystemFilletCommand` · `MatchHeightAndFilletCommand` · `MatchPipeCentersCommand`
Pillar	Drainage

Extend And Connect Pipes

When to use this

Inputs

Returns

Decision flow

What you'll see in the chat

REST API

Keywords & intent patterns

Related