Get a version from the version history of a link

get/links/@item/versions/{version}

Internal-Use Only

Gets the full representation of a version from a link's version history. The link to fetch the full representation is returned with version summaries.

Request Samples

Response Samples

200
application/json
1{
2  "typeName": "intel_report__witnessed_by",
3  "id": "witnessed_by|_|intel_report|_|person|_|e5343e0e-3d68-11e8-b467-0ed5f89f718b",
4  "version": "2",
5  "operation": "update",
6  "createdBy": "videmo",
7  "createdAt": "2023-06-29T22:17:51.061Z",
8  "values": [
9    {
10      "name": "auto_generated_sk",
11      "label": "Auto Generated Sk",
12      "value": "e5343e0e-3d68-11e8-b467-0ed5f89f718b",
13      "type": "STRING",
14      "valueChanged": true
15    },
16    {
17      "name": "personId",
18      "label": "Person Id",
19      "value": "uuid_102",
20      "type": "STRING",
21      "valueChanged": true
22    },
23    {
24      "name": "intelReportId",
25      "label": "Report Id",
26      "value": "uuid_502",
27      "type": "STRING",
28      "valueChanged": true
29    },
30    {
31      "name": "description",
32      "label": "Description",
33      "value": "updated description",
34      "type": "STRING",
35      "valueChanged": true
36    },
37    {
38      "name": "version",
39      "label": "Version",
40      "value": 2,
41      "type": "LONG",
42      "valueChanged": true
43    },
44    {
45      "name": "created_by_user_id",
46      "label": "Created By User Id",
47      "value": "unit_test",
48      "type": "STRING",
49      "valueChanged": true
50    },
51    {
52      "name": "created_at_dttm",
53      "label": "Created at Date/Time",
54      "value": "2015-10-01T18:30:03.656Z",
55      "type": "TIMESTAMP",
56      "valueChanged": true
57    },
58    {
59      "name": "last_updated_by_user_id",
60      "label": "Last Updated By User Id",
61      "value": "videmo",
62      "type": "STRING",
63      "valueChanged": true
64    },
65    {
66      "name": "last_updated_at_dttm",
67      "label": "Last Updated at Date/Time",
68      "value": "2023-06-29T22:17:51.061Z",
69      "type": "TIMESTAMP",
70      "valueChanged": true
71    }
72  ]
73}

Path Parameters

Name	Type	Required	Description
version	string	true	The version of the links history to fetch.

Query Parameters

Name	Type	Required	Description
changedOnly	boolean	false	Specifies whether to return only fields that have changed between the previous and requested link version. Default: false
includeDisplayLabel	boolean	false	Specifies whether to include the display label for the link in the version. Default: false
_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}`

Responses

Status	Meaning	Description
200	OK	The request succeeded.	Schema
400	Bad Request	Version history was not available for the specified link.	Schema
404	Not Found	The specified link or the requested version was not found.	Schema