RelationshipAttributes are always associated with a Relationship between two Identities. Consequently, in contrast to IdentityAttributes, there cannot be unshared RelationshipAttributes. Instead, you and your peer will always each have a LocalAttribute with the same RelationshipAttribute as content and which only differs in the shareInfo.peer property. Thus, wanting to create a new RelationshipAttribute, a Request is sent to the peer via Message. Only if the peer accepts this Request, the RelationshipAttribute will be created at their side. Once you receive the Response, a LocalAttribute with the same content will be created at your side.

Parameters

  • The content of the RelationshipAttribute you want to create, following the description from the data model, except for the owner, which is automatically set to your Address
  • The Address of the peer
  • Optionally requestMetadata as described in the data model, except for the id and items, which are handled automatically.

On Success

  • A Request is sent via Message to the peer, containing a CreateAttributeRequestItem with the RelationshipAttribute you want to create and share with the peer. Furthermore, the Request is returned.

On Failure

  • The Request cannot be created, if the peer is unknown.
  • The Request cannot be created, if the parameters are malformed.