list_referenced_model_elements
Identifies all model elements that reference a specified target element, enabling comprehensive impact analysis and dependency tracing throughout the model.
Purpose
This tool is critical for understanding the ripple effects of potential changes, discovering element usage patterns, and assessing modification risks before making updates. Returns both element IDs and optionally fetches complete element details with browser URLs, supporting informed decision-making about model changes and refactoring operations.
Tags: AM Read Standard
Input parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id |
string | Yes | - | Project name or UUID |
ref_id |
string | Yes | - | Commit UUID, branch name, or tag name |
element_id |
string | No | null | Element UUID |
element_name |
string | No | null | Element name to search for |
exclude_project_usage |
boolean | No | false | Exclude project usage refs |
include_element_details |
boolean | No | true | Fetch element details |
page |
integer | No | 1 | Page number |
limit |
integer | No | 50 | Results per page |
detail_level |
string | No | "minimal" | "minimal" or "summary" |
Output schema
Table 1. Top-level fields
| Field | Type | Description |
|---|---|---|
| project_id | string | UUID of the project |
| ref_id | string | Branch or commit ID used for the query |
| resolved_branch_id | string | Actual branch UUID resolved from the ref_id |
| target_element_id | string | UUID of the target element being analyzed |
| target_element_name | string | Name of the target element |
| referencing_element_ids | array | Array of UUIDs for all elements that reference the target |
| referencing_names_preview | array | Array of names of referencing elements for quick preview |
| referencing_elements[].elementId | string | Unique identifier for the referencing element |
| referencing_elements[].name | string | Display name of the referencing element |
| referencing_elements[].actual_name | string | Actual declared name of the element in the model |
| referencing_elements[].elementType | string | SysML v2 type of the referencing element |
| referencing_elements[].browser_url | string | Clickable URL to view the element in the web browser |
| pagination.page | integer | Current page number |
| pagination.limit | integer | Maximum results per page |
| pagination.total_records | integer | Total number of referencing elements found |
| pagination.total_pages | integer | Total number of pages available |
| pagination.has_next_page | boolean | Indicates if a next page is available |
| pagination.has_previous_page | boolean | Indicates if a previous page is available |
| pagination.returned_count | integer | Number of elements returned in this response |
| pagination.elements_with_details | integer | Number of elements with detailed information |
| pagination.detail_level | string | Level of detail provided: "minimal", "standard", or "full" |
Common use cases
- Impact analysis
- Find what would be affected by changing an element. Example: "What elements reference PowerSubsystem?"
- Dependency tracing
- Understand element dependencies. Example: "Show me all dependencies on this interface".
- Usage discovery
- Find where an element is used in the model. Example: "Where is the Battery component used?"
- Change impact assessment
- Assess impact before making changes. Example: "If I modify this element, what else is affected?"