Pin Attribute
This operation performs the pinning of an attribute value.
- When getting attribute values, the pinned value is always returned first no matter which survivorship strategy is set for this attribute type.
- If you remove or override a pinned attribute, either using the API or the UI, the pin is removed.
Request
PUT /{attributeValueURI}/pin {"value": true}
Parameter | Required | Details | |
---|---|---|---|
Headers |
Authorization |
Yes |
Information about authentication access token in format Bearer
|
Body |
|
Yes |
JSON object representing attribute value |
Response
JSON objects with:
URI
: URI of attribute that was updated/created.error
: if an object cannot be updated for some reason. Contains details of the problem. Returns only if an object wasn't updated. Some possible errors are as follows:warning
: if object is updated but there were some problems.status
: result of operation, and possible values are OK or failed.
Request
PUT /entities/00005KL/attributes/FirstName/49/pin
Headers:Authorization:Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512,
Content-Type:application/json
Body:{
"value":"true"
}
Response
PUT /entities/00005KL/attributes/FirstName/49/pin
Headers:Authorization:Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512,
Content-Type:application/json
Body:{
"type":"configuration/entityTypes/Reltio.System.Individual/attributes/FirstName",
"value":"Yury",
"URI":"entities/00005KL/attributes/FirstName/49",
"pin":true
}