Update a relationship link

put/links/@item

Internal-Use Only

Updates an existing relationship link where the relationship type has an internal bridge table.

Request Samples

application/json
1

Response Samples

200
application/json
1{
2  "relationshipTypeName": "witnessed_by",
3  "relationshipTypeVersion": 1,
4  "relationshipTypeLabel": "Witnessed by",
5  "id": "witnessed_by|_|intel_report|_|person|_|e5343e0e-3d68-11e8-b467-0ed5f89f718b",
6  "createdAt": "2015-10-01T18:30:03.656Z",
7  "lastUpdatedAt": "2015-10-01T18:30:03.656Z",
8  "displayLabel": "Witnessed by",
9  "fromObjectTypeName": "intel_report",
10  "fromObjectTypeVersion": 3,
11  "fromObjectId": "uuid_502",
12  "fromObjectDisplayLabel": "John Smith",
13  "toObjectTypeName": "person",
14  "toObjectTypeVersion": 6,
15  "toObjectId": "uuid_102",
16  "toObjectDisplayLabel": "John Smith",
17  "fieldValues": {
18    "auto_generated_sk": "e5343e0e-3d68-11e8-b467-0ed5f89f718b",
19    "created_at_dttm": "2015-10-01T18:30:03.656Z",
20    "created_by_user_id": "unit_test",
21    "intelReportId": "uuid_502",
22    "last_updated_at_dttm": "2015-10-01T18:30:03.656Z",
23    "last_updated_by_user_id": "unit_test",
24    "personId": "uuid_102",
25    "version": 1
26  },
27  "qualifiedTypeName": "intel_report__witnessed_by",
28  "restrictedFields": {
29    "ssn": {
30      "masked": {
31        "currentUserIsAuthorizedToReveal": true
32      }
33    }
34  }
35}

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}`
_includeEntityLabels	boolean	false	Specifies whether to compute and include display labels for both the to document and the from document in the response. Default: false

Header Parameters

Name	Type	Required	Description
Accept	string	false	For relationship link fields that use data masking, it is important to avoid accidentally overwriting values in the database with masked values that have been loaded by the client. In general, masking dots should not be stored in the database. The "Accept" HTTP header can be used to control how masked fields are handled during updates. If this HTTP header is not provided or is set to "application/json", then masked field values that are set to null will be ignored. If the "Accept" header is set to "application/vnd.sas.investigation.data.masked.relationshiplink+json" then masked fields that are set to the mask template (nine dots) will be ignored. The "Accept" header value should match the data masking approach that was used to fetch data before an update is performed. Allowed values: application/jsonapplication/vnd.sas.investigation.data.masked.relationshiplink+json
If-Match	string	false	The ETag of the representation in the request. If this header value is provided, it must match the ETag of the current version of the resource on the server. Otherwise, the server responds with a 412 error.

Request Body

An object that represents the link.

A link between two documents as defined by a relationship type. If a field is masked, its value will not appear in the fieldValues object.

Name	Type	Required	Description
relationshipTypeName	string	false	The name of the relationship type that defines this link.
relationshipTypeVersion	integer	false	The internal Data Hub version of the relationship type.
relationshipTypeLabel	string	false	The display label for the relationship type.
id	string	false	The ID of the link.
qualifiedTypeName	string	false	The qualified name of the relationship type. Qualified names are in the format: fromObjectTypeName + "__" + relationshipTypeName.
fromObjectTypeName	string	false	The entity type name for the "From" side of the relationship type.
fromObjectTypeVersion	integer<int64>	false	The internal Data Hub version for the entity type for the "From" side of the relationship type.
fromObjectId	string	false	The document ID for the "From" side of the relationship type.
fromObjectDisplayLabel	string	false	The display label for the document on the "From" side of the relationship type.
toObjectTypeName	string	false	The entity type name for the "To" side of the relationship type.
toObjectTypeVersion	integer<int64>	false	The internal Data Hub version for the entity type for the "To" side of the relationship type.
toObjectId	string	false	The document ID for the "To" side of the relationship type.
toObjectDisplayLabel	string	false	The display label for the document on the "To" side of the relationship type.
validFrom	string<date-time>	false	The timestamp value that indicates the starting datetime for when the link is valid.
validTo	string<date-time>	false	The timestamp value that indicates the ending datetime for when the link is valid.
fieldValues	object	false	The values for the fields that are defined as the attributes of the link.
restrictedFields	Restricted Fields Map	false	The restrictions that apply to the fields of the link. Currently, only masking field restrictions are represented here.
createdAt	string<date-time>	false	The timestamp value that indicates when this link was created.
lastUpdatedAt	string<date-time>	false	The timestamp value that indicates when this link was last modified.

Responses

Status	Meaning	Description
200	OK	The request succeeded.	Headers	Schema
400	Bad Request	The request was invalid.		Schema
404	Not Found	Unable to find the link.		Schema
412	Precondition Failed	The link in the request body was out of date.		Schema
428	Precondition Required	The link in the request body did not contain a version.		Schema