Update relationships between resources according to the partial definitions of the relationships given in the payload of the request. This means that fields not mentioned in the payload will remain unchanged. Up to 1000 relationships can be updated in one operation.
To delete a value from an optional value the setNull
field should be set to true
.
The order of the updated relationships in the response equals the order in the request.
Data required to update relationships.
required | Array of objects (relationshipUpdate) [ 1 .. 1000 ] items |
Relationships stored by CDF.
General error object.
Conflict error. Typically issued if external IDs on any relationship already exists, or if there are duplicate external IDs in the request itself.
{- "items": [
- {
- "externalId": "string",
- "update": {
- "sourceType": {
- "set": "asset"
}, - "sourceExternalId": {
- "set": "string"
}, - "targetType": {
- "set": "asset"
}, - "targetExternalId": {
- "set": "string"
}, - "confidence": {
- "set": 1
}, - "startTime": {
- "set": 1730204346000
}, - "endTime": {
- "set": 1730204346000
}, - "dataSetId": {
- "set": 1
}, - "labels": {
- "add": [
- {
- "externalId": "my.known.id"
}
], - "remove": [
- {
- "externalId": "my.known.id"
}
]
}
}
}
]
}
{- "items": [
- {
- "externalId": "string",
- "sourceExternalId": "string",
- "sourceType": "asset",
- "targetExternalId": "string",
- "targetType": "asset",
- "startTime": 1730204346000,
- "endTime": 1730204346000,
- "confidence": 1,
- "dataSetId": 1,
- "labels": [
- {
- "externalId": "my.known.id"
}
], - "createdTime": 1730204346000,
- "lastUpdatedTime": 1730204346000
}
]
}