BYbynder
Asset ingestion

Upload file initialization

IMPORTANT NOTE These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room.

This step actually starts uploading the file. Send this request to the signed uploadUrl returned by Create upload url. This initializes a resumable (tus) upload. Any file namings have to be base64 encoded/decoded. The response headers - in particular the Location header - are required for the next call, Upload file chunks.

The {uploadUrl} path parameter is a placeholder for the signed URL from the previous step.

post/

Request

  • Base URL
    {uploadUrl}
  • URL
    {uploadUrl}/
  • Auth
    HTTP bearer

Headers

tus-resumablestring required
upload-lengthstring required

Total size of the file to upload, in bytes.

upload-metadatastring byte required

Comma-separated key <base64-value> pairs, e.g. filename ZXhhbXBsZS5wbmc=.

fileidstring required
filenamestring required
authorizationstring required
content-lengthstring required

Response

Upload initialized. Use the returned Location header for the chunk uploads.

Changes

No recorded changes to this operation across all 1 revision of this API.