Update Attribute
Perform update of attribute value representing some source system.
This operation performs an update of attribute value representing some source system.
Request
Parameter | Required | Details | |
---|---|---|---|
Headers | Authorization |
Yes | Information about authentication access token in format Bearer
<accessToken> (see details in Authentication API). |
Source-System |
Yes-if Source-System is not 'Reltio' |
Source system that this request is representing. Example: |
|
Query | crosswalkValue |
No |
ID of an entity object providing this attribute in the source system. Example: an entity comes from Facebook and its identifier in Facebook
is |
crosswalkSourceTable |
SourceTable of an entity object providing this
attribute in the source system. |
||
returnObjects |
Specifies if response should contain created entities. Note: Default value is
true . |
||
Body | Yes |
JSON object representing attribute value. |
Response
JSON objects with:
URI
: URI of attribute that was updated/created.-
object
: attribute value that was updated/created. This parameter is returned if thereturnObjects
query parameter in the request is notfalse
and object was created successfully. -
error
: if an object cannot be updated for some reason. Contains details of the problem. Returns only if an object was not updated.- Possible Errors:
warning
: if object is updated but there were some problems.status
: result of operation; possible values are"OK"
or"failed"
.
Simple Attribute, Same Source System
Same for Enum, Lookup
Request
Simple Attribute, Different Source System
Request
Response
Nested Attribute
Request
Response
Nested Attribute: Granular
Request
Response
Reference Attribute
Use Partial Override
This is the preferred approach; therefore, use it whenever possible. You can update
multiple attributes simultaneously. Defining “dataProvider = false”
and “options = partialOverride”
prevents the attributes of the
Product and Contact entities from being set to NULL where not specified. Using this
approach does not require knowledge of the entity IDs, and it creates the most
efficient association between entity types, attributes, and their crosswalks.
Request
Response