searchEntitiesByType | Atomicwork

Grouped search across entity types (optionally anchored to a source).

Performs a full-text search across multiple entity types and returns results grouped by entity type (e.g., {REQUEST: [...], CHANGE: [...], ASSET: [...]}) instead of a flat paginated list. Same search engine as searchEntities — both hit the same Elasticsearch-backed query pipeline.

Parameters

Name	Type	Required	Description
`per_page`	integer	No	Default: `25`.
`page`	integer	Yes	Default: `1`.
`sort_order`	BaseSearchSortOrder	No
`source_display_id`	string	No	Display ID of the source entity for link-candidate mode (e.g., REQ-123). When provided, the source and its already-linke
`source_entity_type`	`REQUEST` \| `CHANGE`	No	Entity type of the source entity. Required if `source_display_id` is provided.
`reference_key`	string	No	Relationship reference key (e.g., “parent_child”, “relates”, “blocks”). When combined with a source, further filters alr
`search_type`	object	No
`search_components`	object	No
`query`	string	No
`per_page`	integer	No	Default: `10`.
`page`	integer	No	Default: `1`.
`filters`	SearchBaseFilterDTO[]	No