Linking Assets

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.

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

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"]
}