Commands › › Tags All Rooms

Tags All Rooms

writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document must be open with a valid plan or section view active. At least one room must exist in the model (host or linked). At least one room tag family must be loaded in the document. View must support annotation (not 3D or schedules).

After it runs

All visible rooms in the current view are tagged with room tags. Rooms from linked models are tagged using room tags in the host document. Tags are placed at room center points. Summary dialog shows count of tags created and any failures.

When to use this

User wants to tag all rooms in a floor plan quickly.
User needs to add room tags to rooms from linked architectural model.
User wants to verify all rooms are properly tagged before issue.

Don't use this when

Custom UI required for rich tag-type picker. AI path is JSON-first and dialog-free.

Inputs

Name	Kind	Type	Required	Default	Description
`View`	config	`View`	no	null	View to tag rooms in (defaults to active view)
`TagType`	config	`FamilySymbol`	no	null	Room tag type to use
`WithLeader`	config	`bool`	no	false	Whether to add leader lines to tags
`IncludeLinkedRooms`	config	`bool`	no	true	Whether to include rooms from linked models

Returns

Name	Type	Description
`TagsCreated`	`int`	Number of room tags successfully created
`TagsFailed`	`int`	Number of rooms that could not be tagged
`RoomsTagged`	`List<string>`	Names of rooms that were tagged

Decision flow

check: activeView.isValidForAnnotation → proceed
check: activeView.is3D || activeView.isSchedule → fail "Cannot tag in this view type"
check: loadedRoomTags.count == 0 → fail "No room tag families loaded"
check: visibleRooms.count == 0 → fail "No rooms visible in current view"
check: selectedTagType != null → useSelectedTagType
check: selectedTagType == null → useFirstAvailableTagType
resolve: includeLinkedRooms == true → GetAllIncludingLinks, else → GetAll

What you'll see in the chat

on start

Tagging all rooms in the current view...
Starting room annotation workflow...

thinking

Validating view supports annotation...
Finding available room tag families...
Collecting rooms from host and linked models...
Filtering rooms visible in current view...
Placing room tags at centroids...

on success

Tagged {TagsCreated} rooms in view. {TagsFailed} skipped.

on failure

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

Keywords & intent patterns

tag rooms · room tags · tag all rooms · annotation · linked rooms · architectural rooms · room annotation
Patterns: tag * rooms · tag all rooms · add room tags · annotate rooms · room tag * all

Related commands	`CreateSectionFromGridlineCommand` · `PlaceViewOnSheetCommand` · `TagAllCommand`
Pillar