Commands  ›  Drainage  ›  Extend Pipe Down

Extend Pipe Down

Drainage writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open. At least one pipe must exist in the model. User must select a valid pipe element.

After it runs

A new pipe is created extending downwards from the bottom of the selected pipe. Extension length = pipe radius × 5. New pipe matches system, size and family routing types.

When to use this

Don't use this when

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

Side effects

Creates a new pipe element in the model.

Inputs

NameKindTypeRequiredDefaultDescription
Pipe selection Pipe yes Pipe to extend downwards
"Select a pipe to extend downwards"
RadiusMultiplier config double no 5.0 Extension length as multiplier of radius

Returns

NameTypeDescription
ExtensionPipePipeThe created extension pipe

Decision flow

check: document.isOpen → continue
action: promptUserToSelectPipe → getSelectedPipe
check: selectedElement.isPipe → continue, else → error
action: getPipeProperties → system, size, routing
action: calculateExtensionLength → radius × 5
action: createExtensionPipe → addToModel
resolve: success → showSuccess, else → showError

What you'll see in the chat

on start
Extending pipe downwards...
Preparing downward pipe extension...
thinking
Getting pipe properties (system, size, routing)...
Calculating extension length from radius...
Creating extension pipe below selected pipe...
on success
Pipe extended downwards — diameter matched.
on failure
Couldn't extend pipe down: {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_pipe_down
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

extend pipe down · pipe extension down · extend downward · grow pipe down · lengthen pipe
Patterns: extend * pipe * down · grow * pipe * down · lengthen * down

Related commandsExtendPipeUpCommand · PlaceSVPCommand
PillarDrainage