Upload file in chunks
Uploading a file consists of the following two parts:
1. Breaking down your file into parts/chunks
Each part must be at least 5 MB in size, except for the last part. There is no size limit on the last part of your multipart upload. For more information about how Amazon handles parts/chunks, visit Amazon’s website.
2. Sending the chunks to Amazon and registering them with Bynder
You can repeat these calls until your file has been uploaded completely.
Upload a chunk
Make a POST request to the Amazon upload endpoint you received from calling Get closest AmazonS3 upload endpoint. Use multipart/form-data to send all of the parameters included in the multipart_params of the previous request, plus the additional parameters listed below.
Response
200
Response
Step 3B Register uploaded chunk
This endpoint finalizes the upload after all chunks have been uploaded. You need to provide the file ID and details about the file, including its name, size, and the number of chunks it was split into.
Register uploaded chunk
Register the completion of an uploaded chunk.
Path Parameters
Example:T3.fS5.5HPhtYFtm2b_.e7wVe910tL5XQutKw1jkMqlP5cPQVyZkOZxZ9lJiGUk4FIw6M0CFZ3xogTWrm.GPI2p2CaglQcAS5aH37zT_vHJnbtkebYbheXIQc_.M_6hM
Headers
Body
application/x-www-form-urlencoded
Body
required for every chunk
Example:5
required for every chunk
Example:api_uploads/00000000-0000-0000-0000000000000000/00000000-0000-0000-0000000000000000/Logo.png/p5
required for every chunk
Example:final/00000000-0000-0000-0000000000000000/Logo.png
Response
application/json
Response
Chunk registered successfully
ApiV4UploadResponse
Example:00000000-0000-0000-0000000000000000
Show Child Parameters
Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/IMG_1874.JPG
Example:000000000-0000-0000-0000000000000000
Example:s3
Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/
Only for chunk registration
Example:ok
Example:1
Authentication
Path Parameters
Headers
Body
Step 4 EITHER Finalise uploaded file
Finalise an uploaded file
The endpoints described in Step 4 are an Either/Or choice. You should use either the Finalise an uploaded file endpoint to finalize and process a standard upload, or the Finalize additional file endpoint to finalize and save an additional uploaded file as a new asset.
Path Parameters
Example:T3.fS5.5HPhtYFtm2b_.e7wVe910tL5XQutKw1jkMqlP5cPQVyZkOZxZ9lJiGUk4FIw6M0CFZ3xogTWrm.GPI2p2CaglQcAS5aH37zT_vHJnbtkebYbheXIQc_.M_6hM
Headers
Body
application/x-www-form-urlencoded
Body
Total number of chunks uploaded.
Example:5
Filename including special characters to be displayed in Bynder.
Example:Logo.png
Base location of the uploaded file.
Example:api_uploads/159D8D4B-B981-49B8-BF0569FD144CB359/A29FABF0-26B8-44BF-890920E4C09E7C11/Logo.png
Target id as returned by the initialise call.
Example:final/E3333526-7F87-49F9-B49C0054C0D31477/Logo.png
Response
application/json
Response
Accepted
ApiV4UploadResponse1
Example:00000000-0000-0000-0000000000000000
Show Child Parameters
Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/IMG_1874.JPG
Example:000000000-0000-0000-0000000000000000
Example:s3
Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/
Example:1