Create Architecture Link (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

Create an authorization link between two custom nodes in an architecture custom view.

This operation is supported for architecture custom views only.

URI

POST /rest/applications/{name}/custom-views/architecture/link

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.

Request Body

{
    "modeId": "abc123-def456",
    "sourceId": "4:abc:123",
    "targetId": "4:abc:456"
}

Property	Type	Required	Description
modeId	string	Yes	ID of the custom view to add the link to. The referenced view must be `Architecture`.
sourceId	string	Yes	ID of the source custom node.
targetId	string	Yes	ID of the target custom node. Must be different from `sourceId`.

Responses

application/json

Example:

{
    "success": {
        "id": "5:def789:1",
        "sourceId": "4:abc:123",
        "targetId": "4:abc:456",
        "linkType": "USER_LINK",
        "createdBy": "jdoe",
        "createdAt": "2024-01-15T00:00:00Z"
    }
}

Error Response

{
    "error": "modeId, sourceId, and a distinct targetId are required"
}

JSON representation

Property	Type	Description
success	object	The created link.
success.id	string	Unique identifier of the link relationship.
success.sourceId	string	Source custom node ID.
success.targetId	string	Target custom node ID.
success.linkType	string	Always `USER_LINK`, distinguishing authorization links from computed ones.
success.createdBy	string	Username of the creator.
success.createdAt	string	Creation timestamp.
error	string	Error message if the link could not be created.