Get shared versions of an Attribute

This use case allows you to retrieve a list of shared LocalAttributes for a given source Attribute. In case of IdentityAttributes a list comprising of own shared IdentityAttributes for the specified RepositoryAttribute is returned. In case of RelationshipAttributes the list contains ThirdPartyRelationshipAttributes you re-shared based on the specified RelationshipAttribute.

Parameters

• The attributeId belonging to a LocalAttribute you would like to know all shared versions of
• Optionally the returned LocalAttributes can be limited to those shared with specific peers.
• onlyLatestVersions omits succeeded versions such that only the most recent version you shared per peer is returned. In detail, this means that if the attributeId given as input belongs to a LocalAttribute, that already has successors you also shared with the peer, only the shared copy corresponding to the most recently shared successor will be returned. By default this is set to be true.

On Success

• A list of shared LocalAttribute versions of the source Attribute belonging to the attributeId given as input is returned.
• If peers were specified, the list is limited to the entries shared with those peers.
• If onlyLatestVersions is disabled, all versions will be returned, even if they already have successors.

On Failure

• No LocalAttributes can be returned if the attributeId correlates to an unknown LocalAttribute.
• No LocalAttributes can be returned if an empty list is provided for peers.
• No LocalAttributes can be returned if the parameters are malformed.

How to execute this use case with the Connector?

The Connector is our first-class citizen, thus we provide you with a detailed API description for every use case. This use case can be executed with the REST API of the Connector which you can Access the Connector.

Corresponding interactive API docs excerpt: