Get Custom Aggregation (RESERVED)
RESERVED: The keyword RESERVED annotation means that the API is available for use but is not yet part of the officially supported specification. Its behavior, interface, or output may change in future releases without backward compatibility guarantees.
Overview
Get the stored aggregation graph for a static custom view. This returns the visual representation of the static custom view including its custom nodes and relationships.
Use this endpoint only for custom views whose aggregationType is Static in the custom view list response.
URI
GET /rest/applications/{name}/custom-views/{viewId}
Path parameters
name (string)
This parameter identifies the analyzed application. The application name must be properly encoded if required. Character back-quote is not allowed.
viewId (string)
The unique identifier of the custom view.
Query parameters
type (string)
Optional. The response type. Default is graph. Options:
graph: Returns the full graph with nodes and edges.details: Returns metadata details about the aggregation.
shared (boolean)
Optional. Whether to include Shared virtual relationships between custom nodes. Default is false.
Notes
- This endpoint is intended for static custom views.
- The
sharedquery parameter is accepted for consistency with dynamic graph retrieval, but static custom-view graphs are stored graphs rather than dynamically recomputed graphs. - If the target custom view is dynamic, the API returns a client error and the caller should use:
GET /rest/applications/{name}/custom-views/{viewId}/dynamic
Responses
application/json
Graph Response (type=graph)
{
"success": {
"graph": {
"nodes": [
{
"id": "4:abc:123",
"data": {
"Name": "Business Services",
"Count": 42
}
},
{
"id": "4:abc:456",
"data": {
"Name": "Persistence",
"Count": 18
}
}
],
"edges": [
{
"id": "4:abc:123_CALL_4:abc:456",
"source": "4:abc:123",
"target": "4:abc:456",
"type": "CALL",
"data": {
"Count": 12,
"Type": "CALL"
}
}
]
},
"documents": []
}
}
Details Response (type=details)
{
"success": {
"duplicated": 0,
"total": 60,
"grouped": 60
}
}
JSON representation (Graph)
| Property | Type | Description |
|---|---|---|
| success.graph.nodes | []object | Array of custom nodes in the view. |
| success.graph.nodes[].id | string | The node’s unique identifier. |
| success.graph.nodes[].data | object | Node metadata, including name, count, parameters, and labels. |
| success.graph.edges | []object | Array of relationships between custom nodes. |
| success.graph.edges[].id | string | Unique identifier of the relationship. |
| success.graph.edges[].source | string | Source custom node ID. |
| success.graph.edges[].target | string | Target custom node ID. |
| success.graph.edges[].type | string | Relationship type (for example CALL or Shared). |
| success.graph.edges[].data | object | Relationship metadata, including Count. |
| success.documents | []object | Associated documents for the aggregation response. |
JSON representation (Details)
| Property | Type | Description |
|---|---|---|
| success.duplicated | integer | Number of duplicated objects in the aggregation. |
| success.total | integer | Total number of objects considered by the aggregation. |
| success.grouped | integer | Number of objects currently grouped in the custom view. |