Validate Architecture Links (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
Compare the authorization links in an architecture custom view against the real object-level relationships between the underlying objects. Each entry in the response is one of:
expected: an authorization link you created (via Create Architecture Link), regardless of whether it is backed by a real dependency. This reflects the architecture you intended.violated: a real dependency between two custom nodes that has no matching authorized link. This flags actual code dependencies that break the architecture you defined.
A link you authorized that has no real dependency behind it is still reported as expected — this endpoint does not currently flag “unused” authorized links.
Use this endpoint only for custom views whose aggregationType is Architecture in the custom view list response.
URI
GET /rest/applications/{name}/custom-views/{viewId}/architecture/validate
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
date (string)
Optional. A valid datetime (e.g. 2024-01-15T00:00:00Z) forwarded to the aggregation service to validate links against the underlying objects as they existed at that point in history.
Notes
- This endpoint is intended for architecture custom views only.
- If the target custom view is not an architecture view, the API returns a client error.
Responses
application/json
Example:
{
"success": [
{
"sourceId": "4:abc:123",
"targetId": "4:abc:456",
"validation": "expected"
},
{
"sourceId": "4:abc:456",
"targetId": "4:abc:789",
"validation": "violated"
}
]
}
JSON representation
| Property | Type | Description |
|---|---|---|
| success | []object | Array of authorized links (expected) and unauthorized real dependencies (violated). |
| success[].sourceId | string | Source custom node ID. |
| success[].targetId | string | Target custom node ID. |
| success[].validation | string | expected for an authorization link you created (regardless of whether it matches reality); violated for a real dependency with no matching authorization link. |