From Safe Creative API
Revision as of 08:07, 7 May 2021 by Adminwiki (talk | contribs) (11 revisions imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Returns an upload URL and upload ID.

To upload a work you must use work.upload.begin, work.upload.chunk and work.upload.commit or upload the file by POST to an API upload servlet. These components are not available through the standard API endpoint ( but through dedicated upload servers. Before calling any of these components, you must call work.upload.lookup to get an upload server and id.


  • Component name: work.upload.lookup
  • Signature: Requires signature using the authkey's private key
  • Timestamp: Requires ztime parameter
  • Authorization level: ADD
  • API trust level: Standard


* Required parameter


  • workuploadlookup
    • uploadurl: Upload URL
      • If bypost is true, uploadurl is the direct URL to an API upload servlet which will handle the HTTP POST upload
      • If bypost is false, uploadurl is the base URL of the upload API server (you will need to add /v2/ to the URL when calling components)
    • uploadid: Upload ID, must be used as a parameter in the rest of upload components




<?xml version="1.0" encoding="UTF-8"?>

REQUEST (bypost):

RESPONSE (bypost):

<?xml version="1.0" encoding="UTF-8"?>