This use case regenerates the ownershipToken of a File.

Parameters

  • id of the File.

On Success

  • A new ownershipToken is generated for the File.
  • The ownership of the File is unlocked, meaning that it is possible to claim the ownership of the File with the new ownershipToken.
  • The corresponding indicator ownershipIsLocked is set to undefined.
  • The updated File is returned.

On Failure

  • The parameters are malformed.
  • There was no File found with the specified id.
  • The use case was called by an Identity who is not the owner of the File.

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: