Linking Assets
On this page
Linking assets
Any asset can be linked to each other to create a link between two assets. This allows for flexible connections between any asset. A few usage examples:
- Link amendments of a documentation to the original asset.
- Link multiple documents together as a collection.
- Link “signatures” to a document for verification.
Important note: Only the owner of the asset defined in the URL can use it to link with other assets. You can’t arbitrarily choose any other asset and link it with your own or other assets.
POST /assets/{assetId}/links
{
"targetAssetIds": ["string"]
}
- linkedAssetIds: The assets that should be linked to the parent asset defined in the URL.
Seeing asset links
To see all the links for the asset, a request to GET /assets/{assetID}/links can be sent. The following ouput can be received:
{
"value": {
"from": ["string"],
"to": ["string"]
}
}
- from: These are the assets that are the parent of the assets. This would mean string -> assetID
- to: These are assets that are the child of the asset. This would mean assetID -> string
Removing links
Links are not permanent, they can at any time be revoked if so desired. This can be useful if for example a signature should be revoked for any reason or a document amendment was faulty.
PATCH /assets/{assetId}/links
{
"targetAssetIds": ["string"]
}