Work.rightsholders.remove: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Mpolo
(Fix add->remove)
m (5 revisions imported)
 
(No difference)

Latest revision as of 08:07, 7 May 2021

Requests to remove a user as author or copyright holder of a work.

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

A mail will be sent to the user for confirmation. This method returns the confirmation URL sent to the user.

Info

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

Parameters

  • authkey*: Authorization key
  • ztime*: Z-Timestamp
  • workcode*: Work code
  • usercode*: Safe Creative code of the user to remove

* Required parameter

Returns

  • confirm-url: Confirmation URL as sent in the mail

Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.rightsholders.remove
&authkey=1i5g2aaf2bz09lyo867cuimqg
&workcode=1004200146116
&usercode=0909160000830
&ztime=1271749848300
&signature=2975fb609c151e46ca26bbaabab16732288b126a

RESPONSE:

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