Commands › › Select By Parameter

Select By Parameter

writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open with a valid active view.

After it runs

Revit selection is replaced with elements where at least one parameter contains the search text. Returns JSON with totalSelected, totalSearched, and breakdown. NOTE: Slower than SelectByCategoryCommand/SelectByFamilyNameCommand — searches ALL parameters.

When to use this

User wants to find all elements marked "emergency" in any parameter.
User wants to select elements with a specific circuit name or system name.
User wants to find elements by a value buried in type parameters.

Don't use this when

Simple category selection (use SelectByCategoryCommand — much faster). Family name search (use SelectByFamilyNameCommand — faster).

Inputs

Name	Kind	Type	Required	Default	Description
`search`	config	`string`	no	—	Text to search for in ALL parameter values
`category`	config	`string`	no	—	Optional category to narrow search (recommended for performance)
`scope`	config	`string`	no	"view"	view (default) or model

Returns

Name	Type	Description
`Selection`	`ElementId[]`	Selected element IDs
`Summary`	`JSON`	Breakdown by family:type and count

Decision flow

check: parameters.search → required, fail if empty
check: parameters.category → optional, narrows collector for performance
check: parameters.scope == "model" → search entire model
default: search current view only

What you'll see in the chat

on start

Searching all parameter values for your text...
Running deep parameter search across elements...
Starting parameter value search — this may take a moment...

thinking

Building element collector...
Searching every parameter on each element...
Matching parameter values against search term...
Applying selection to model...

on success

Selected {totalSelected} elements with parameter values matching "{searchTerm}" from {scope}

on failure

Parameter search 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/select_by_parameter
Request body schema (from [RestApiParam])
Response schema (from [RestApiResponse])
curl / JS / Python code examples

Keywords & intent patterns

select by parameter · search parameter value · find by value · parameter search · select by text
Patterns: select * parameter * · find * parameter * · select * with * value

Related commands	`SelectByCategoryCommand` · `SelectByFamilyNameCommand` · `FilterSelectionCommand`
Pillar

Select By Parameter

When to use this

Inputs

Returns

Decision flow

What you'll see in the chat

REST API

Keywords & intent patterns

Related