Metavault API - Get Link

GetLink - GET

Path	/api/projects/{projectId}/model/links/{linkId}
Http Method	GET

Overview

Get a link.

Required permissions

Write access to the Build module. BUILD READ

Response

Success response (200 OK)

JSON

{
  "self": "/api/projects/{projectId}/model/links/{linkId}",
  "id": "link-12345",
  "name": "CustomerOrderLink",
  "businessName": "Customer Order Link",
  "linkType": "Relationship",
  "businessDescription": "Links customers to orders",
  "technicalDescription": "Link table connecting customer and order hubs",
  "deployedInProduction": false,
  "tableName": "LNK_CUSTOMER_ORDER",
  "entityType": "Link",
  "dependentChildColumns": [
    {
      "id": "col-1",
      "columnName": "LOAD_DATE",
      "dataType": "DateTime",
      "length": null,
      "precision": null,
      "scale": null,
      "typeFullName": "DateTime"
    }
  ],
  "dataColumns": [],

  "_embedded": {
    "hubReferences": {
      "self": "/api/projects/{projectId}/model/links/{linkId}/hubreferences",
      "total": 2,
      "_embedded": {
        "hubReferences": [
          {
            "id": "hr-1",
            "columnName": "CUSTOMER_HK",
            "order": 0,
            "hubId": "hub-123",
            "linkId": "link-12345",
            "_links": {
              "hub": "/api/projects/{projectId}/model/hubs/hub-123"
            }
          }
        ]
      }
    }
  }
}

Response fields

Field	Type	Description
name	string	The name of the entity.
businessName tba	string	The business name of the entity.
technicalDescription	string	The technical description of the link.
businessDescription	string	The business description of the link.
_embedded.hubReferences.self	string	Url to get the hub reference of the link Updated
_embedded.hubReferences.total	int	Number of hub references in the link
_embedded.hubReferences._embedded.hubReferences[].id	string	Hub reference identifier
_embedded.hubReferences._embedded.hubReferences[].columnName	string	Column name for the hub reference
_embedded.hubReferences._embedded.hubReferences[].order	integer	Order of the hub reference
_embedded.hubReferences._embedded.hubReferences[].hubid	string	ID of the referenced hub
_embedded.hubReferences._embedded.hubReferences[].linkId	string	ID of the link
_embedded.hubReferences._embedded.hubReferences[]._links.hub	uri	URI reference to the hub
dependentChildColumns	array	Array of dependent child columns
dependentChildColumns[].linkId	string	Link identifier
dependentChildColumns[].columnName	string	Column name
dependentChildColumns[].dataType	string	The name of the type of the column. This is one of .NET’s `System.Data.DbType` values. https://learn.microsoft.com/en-us/dotnet/api/system.data.dbtype?view=net-8.0
dependentChildColumns[].length	integer	Length of the column
dependentChildColumns[].precision	integer	Precision of the column
dependentChildColumns[].scale	integer	Scale of the column
dataColumns	array	Array of data columns
dataColumns[].linkId	string	Link identifier
dataColumns[].columnName	string	Column name
dataColumns[].dataType	string	The name of the type of the column. This is one of .NET’s `System.Data.DbType` values. https://learn.microsoft.com/en-us/dotnet/api/system.data.dbtype?view=net-8.0
dataColumns[].length	integer	The length of the type.
dataColumns[].precision	integer	The precision of the type.
dataColumns[].scale	integer	The scale of the type.

Response links and embedded objects

Name	Link	Constraints
project
satellites
pitTables
mappings
hubReferences