https://www.safecreative.org/mw/index.php?action=history&feed=atom&title=Work.changethumbnailWork.changethumbnail - Revision history2026-05-03T14:31:45ZRevision history for this page on the wikiMediaWiki 1.43.1https://www.safecreative.org/mw/index.php?title=Work.changethumbnail&diff=820&oldid=prevAdminwiki: Created page with "Changes the thhumbnail of a work. The thumbnail image can be specified: * with an upload ticket obtained from a previous upload (see work.upload.lookup) * with an url whe..."2022-04-20T10:38:32Z<p>Created page with "Changes the thhumbnail of a work. The thumbnail image can be specified: * with an upload ticket obtained from a previous upload (see <a href="/api-doc/Work.upload.lookup" title="Work.upload.lookup">work.upload.lookup</a>) * with an url whe..."</p>
<p><b>New page</b></p><div>Changes the thhumbnail of a work.<br />
<br />
The thumbnail image can be specified:<br />
* with an upload ticket obtained from a previous upload (see [[work.upload.lookup]])<br />
* with an url where the image will be downloaded from<br />
<br />
Using an upload ticket is a synchronous operation, the thumbnail will be changed as soon as the call ends. If you use an url, the call will end immediately and the download will be queued. Once the thumbnail is downloaded, it will be changed in the work.<br />
<br />
The work must be in REGISTERED or PRE_REGISTERED state. If the work is PRE_REGISTERED and the work file is changed, the custom thumbnail will be lost and a new thumbnail will be generated from the new file.<br />
<br />
If you are a partner, you can register a work as a copyright information provider (or informer). The authorizing user will be registered as informer and you must provide the authors' and copyright holders' names (see [[How to: Register a work as a copyright info provider]]).<br />
<br />
= Info =<br />
* '''Component name:''' work.changethumbnail<br />
* '''Signature:''' Requires signature using the authkey's private key<br />
* '''Timestamp:''' Requires [[ztime parameter]]<br />
* '''Authorization level:''' <br />
** MANAGE<br />
* '''API trust level''': Standard<br />
<br />
= Parameters = <br />
* '''authkey*:''' Authorization key<br />
* '''ztime*:''' Z-Timestamp<br />
* '''workcode*''': Code of the work you want to modify<br />
* '''uploadticket:''' upload ticket obtained from [[work.upload.commit]] or the [[upload servlet]]<br />
* '''url:''' URL of the image to be used as thumbnail<br />
<br />
You must use either the ''url'' or ''uploadticket'' parameters, but not both.<br />
<br />
= Returns =<br />
* '''restvalueresponse'''<br />
** '''state''': ready<br />
<br />
<br />
= Example =<br />
<br />
REQUEST:<br />
<br />
<nowiki>https://api.safecreative.org/v2/</nowiki><br />
?'''component'''=work.changethumbnail<br />
&'''authkey'''=1cae00nyf3z3ooi6hdcgqnmc5<br />
&'''url'''=https%3A%2F%2Fgateway.pinata.cloud%2Fipfs%2FQmZP3nkJiAFyLAkRgZjcqjJWVg53ZyqfueftUzmB8g7Mio<br />
&'''workcode'''=2204200018744<br />
&'''ztime'''=1650435290212<br />
&'''signature'''=101e7fc8bc1c142a02141b3a369dd0572e381f75<br />
<br />
RESPONSE:<br />
<br />
<pre><br />
<?xml version="1.0" encoding="UTF-8"?><br />
<restvalueresponse><br />
<state>ready</state><br />
</restvalueresponse><br />
</pre><br />
<br />
[[Category:API component]]</div>Adminwiki