Commands › › Select By Room
Select By Room
Coming soon
Before you run this
Active document; roomNumber or roomName required.
After it runs
Returns { success, count, room, items }; optionally selection set.
When to use this
- List/filter elements in a room; then use get_selection or SelectByIdsCommand for cross-off.
Don't use this when
Selecting by coordinates — use SelectByLocationCommand. Selecting by ID — use SelectByIdsCommand.
Inputs
| Name | Kind | Type | Required | Default | Description |
|---|---|---|---|---|---|
roomNumber |
config | string |
no | — | Room number (e.g. 101) |
roomName |
config | string |
no | — | Room name (e.g. Office) |
setSelection |
config | bool |
no | — | If true, set Revit selection to elements in room |
Returns
| Name | Type | Description |
|---|---|---|
count | int | Number of elements in room |
items | JSON | Lightweight list: id, category, name |
What you'll see in the chat
on start
Finding elements in the specified room...
Searching room for elements...
Searching room for elements...
thinking
Resolving room by number or name...
Collecting elements within room boundary...
Building result set...
Collecting elements within room boundary...
Building result set...
on success
Found {count} element(s) in room {room}.
on failure
Could not find elements in room: {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_room- Request body schema (from
[RestApiParam]) - Response schema (from
[RestApiResponse]) - curl / JS / Python code examples
Keywords & intent patterns
select by room · elements in room · room filter · room elements · room contents
Related
| Related commands | SelectByIdsCommand · SelectByLocationCommand |
|---|---|
| Pillar |