Validate Architecture Links (RESERVED)


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.