Succeed an OwnIdentityAttribute
If the content.value of an OwnIdentityAttribute changes, this can be replicated in enmeshed with this use case.
It allows you to update the content and keeps a coherent history of all versions by establishing a doubly linked list, using the OwnIdentityAttribute’s parameters succeeds and succeededBy.
Hence, every OwnIdentityAttribute may have exactly one predecessor and one successor.
In case you shared the preceeding version of an OwnIdentityAttribute, the corresponding successor will only be shared if you decide to notify the peer about the succession.
Parameters
predecessorIddescribes theidof the OwnIdentityAttribute you want to succeed.- The
successorContentaccording to the parameters of an IdentityAttribute as described in the data model, except for theowner, which is automatically set to theaddressof your Identity.
On Success
- The response returns a
predecessorand asuccessorOwnIdentityAttribute. - The
predecessoris an updated version of the OwnIdentityAttribute belonging topredecessorId, having thesucceededByfield set to theidof thesuccessor. - The
successoris a new OwnIdentityAttribute with the updatedsuccessorContent. Itssucceedsproperty links to thepredecessor.
On Failure
- The response cannot be created if the
predecessorIddoesn’t belong to an OwnIdentityAttribute. - The response cannot be created if the OwnIdentityAttribute already has a successor.
- The response cannot be created if the
successorContentcontains invalid changes, e.g. of the IdentityAttributevalue.@type. - The response cannot be created if the parameters are malformed.