Object Relationships (Reserved)
Overview
Get the relationship graph (nodes and edges) for a set of objects in an application. This endpoint returns a graph representation showing how multiple objects are connected through various relationship types.
URI
POST /rest/applications/{name}/objects/relationships?linkMode=direct
Path parameters
name (string)
This parameter identifies the analyzed application. The application name must be properly encoded if it is required. Character back-quote is not allowed.
Query parameters
linkMode (string)
Optional, default: direct:
linkMode=direct: only direct links are included in the response (excludes escalated links).linkMode=escalated: only escalated/reference links are included in the response.linkMode=all: both direct and escalated links are included in the response.
Request Body
application/json
The request body must contain an array of object IDs to retrieve relationships for:
{
"objectIds": ["1234", "5678", "9012"]
}
Request Body Fields
| Property | Type | Required | Description |
|---|---|---|---|
| objectIds | string[] | Yes | Array of object IDs to retrieve relationships for |
Responses
application/json
A graph representation containing nodes and edges. Example:
{
"nodes": [
{
"id": "1234",
"data": {
"name": "OrderService",
"type": "Java Class",
}
},
{
"id": "5678",
"data": {
"name": "ProductService",
"type": "Java Class",
}
}
],
"edges": [
{
"source": "1234",
"target": "5678",
"type": "CALL",
"isEscalated": false
}
],
"warnings": []
}
JSON representation
Response Object
| Property | Type | Description |
|---|---|---|
| nodes | array | Array of object nodes in the relationship graph |
| edges | array | Array of relationship edges connecting the nodes |
| warnings | string[] | Optional array of warning messages (e.g., invalid IDs) |
Node Object
| Property | Type | Description |
|---|---|---|
| id | string | The object ID |
| data | object | Object containing the object’s properties (name, type, typeId) |
Edge Object
| Property | Type | Description |
|---|---|---|
| source | string | The source object ID (origin of the relationship) |
| target | string | The target object ID (destination of the relationship) |
| type | string | The relationship type identifier (see CALL Link Type) |
| isEscalated | boolean | Indicates whether this is an escalated/reference link (true) or a direct link (false) |