This API exposes replace semantics. Therefore, all the existing relationships of the specified relationshipType will be removed and replaced with the resources specified as part of the request body.
- If at least a few of the Resource that are part of relatedIds list are valid resources then the operation is performed.
- If there are few Resource that are part of relatedIds list that will result in a cyclical relationship, then the operation is aborted.
NOTE: Setting relationship is not synchronous. As a result, the set operation may not happen immediately. It is recommended to query the relationships of the specific Resource back to ensure that the operation was indeed successful.
The UUID of the source resource
The type of relationship of the objects; Uses the RelationshipType.representation value
All of the Resource that are part of the relatedIds list are invalid/non-existent