Query an individual link

get/links/@item

Retrieves an individual link using an ID string.

Request Samples

Response Samples


1{
2  "relationshipTypeName": "string",
3  "relationshipTypeVersion": "string",
4  "relationshipTypeLabel": "string",
5  "id": "string",
6  "qualifiedTypeName": "string",
7  "fromObjectTypeName": "string",
8  "fromObjectTypeVersion": -9223372036854776000,
9  "fromObjectId": "string",
10  "fromObjectDisplayLabel": "string",
11  "toObjectTypeName": "string",
12  "toObjectTypeVersion": -9223372036854776000,
13  "toObjectId": "string",
14  "toObjectDisplayLabel": "string",
15  "validFrom": "2019-08-24T14:15:22Z",
16  "validTo": "2019-08-24T14:15:22Z",
17  "createdAt": "2019-08-24T14:15:22Z",
18  "lastUpdatedAt": "2019-08-24T14:15:22Z",
19  "@type": "string"
20}

Query Parameters

Name	Type	Required	Description
_id	string	true	The ID for an individual link. A link ID uses the following format: `${relationshipName}\|_\|${fromEntityTypeName}\|_\|${toEntityTypeName}\|_\|${fromEntityId}\|_\|${toEntityId}` where `\|_\|` is the delimiter between link ID components. Link ID component details: `relationshipName` - The relationship type name that defines the link. `fromEntityTypeName` - The entity type name of the starting point for the link. `fromEntityId` - The unique identifier of the entity that is the starting point for the link. `toEntityTypeName` - The entity type name of the destination point for the link. `toEntityId` - The unique identifier of the entity that is the destination point for the link. When submitting the request, the pipe character (`\|`) must be percent-encoded as `%7C`. See below for an example of the pipe character properly encoded: `${relationshipName}%7C_%7C${fromEntityTypeName}%7C_%7C${toEntityTypeName}%7C_%7C${fromEntityId}%7C_%7C${toEntityId}`
_includeDisplayLabel	boolean	false	Compute and include display labels for both to and from documents in the response.

Responses

Status	Meaning	Description
200	OK	The request succeeded. An individual link is returned.	Schema
400	Bad Request	The request was invalid.	Schema
404	Not Found	Unable to find the link.	Schema