Work.rightsholders.add

Add a user as a copyright holder of a work.

'Shared rights management' professional service must be active for the authorizing user.

A mail will be sent to the provided address asking for confirmation. This method returns the confirmation URL sent to the mail address.

Info

• Component name: work.rightsholders.add
• Signature: Requires signature using the authorization key's private key
• Timestamp: Requires ztime parameter
• Authorization level: MANAGE

Parameters

• authkey*: Authorization key
• ztime*: Z-Timestamp
• workcode*: Work code
• mail*: E-mail address of the copyright holder
• roles*: Comma-separated list of any of the following values: AUTHOR, RIGHTS_OWNER
• canedit*: 1 if user will be able to edit the work
• private: 1 if user will not appear in the work public authors / right holders list

* Required parameter

Returns

• confirm-url: Confirmation URL as sent in the mail to the new copyright holder

Sample

REQUEST:

https://api.safecreative.org/v2/
?authkey=1i5g2aaf2bz09lyo867cuimqg
&component=work.rightsholders.add
&mail=sholmes%40baker.fake
&roles=AUTHOR%2CRIGHTS_OWNER
&canedit=1
&workcode=1004200146116
&ztime=1271749848300
&signature=2975fb609c151e46ca26bbaabab16732288b126a

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<confirm-url>https://www.safecreative.org/shareconfirm/8b017250f9d74615951b94ed4d492384</confirm-url>