Commands  ›  Drainage  ›  Extend All Connectors

Extend All Connectors

Drainage writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open. Selected element(s) must have pipe connectors (FamilyInstance with MEPModel or MEPCurve).

After it runs

Pipes created from all unconnected connectors on each selected element. Each pipe uses ExtensionLength (default 100 mm). Pipes are connected to the fitting.

When to use this

Don't use this when

When selection is empty and run from MCP, command will prompt for pick — pre-select via select_by_ids first.

Side effects

Creates new pipe elements. Connects pipes to the selected fitting.

Inputs

NameKindTypeRequiredDefaultDescription
Element selection Element yes Fitting or MEP object with connectors
"Select fitting or object to extend pipes from"
ExtensionLength config double no 100.0 Length of pipe extensions in mm

Returns

NameTypeDescription
CreatedPipesList<Pipe>The pipes created

Decision flow

check: document.isOpen → continue
action: promptUserToSelectElement → getElement
check: elementHasConnectors → continue, else → error
action: getUnconnectedPipeConnectors → connectorList
action: createPipeFromEachConnector → pipeList
action: connectPipesToFitting → connect
resolve: success → complete, else → showError

What you'll see in the chat

on start
Extending pipes from all connectors on your selection...
Creating pipe stubs from fitting connectors...
thinking
Checking selection for valid fittings...
Identifying unconnected pipe connectors...
Creating extension pipes and connecting to fittings...
on success
Created {totalPipesCreated} pipe(s) from {elementsWithPipes} element(s).
on failure
Failed to extend connectors: {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_all_connectors
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

extend connectors · pipe stubs · fitting pipes · all connectors · extend all
Patterns: extend * connectors · pipe stubs * fitting · create pipes * connectors

Related commandsExtendPipeUpCommand · ExtendPipeDownCommand · PlaceSVPCommand · SelectByIdsCommand
PillarDrainage