Upload Assets

Save uploaded file to existing asset

Be aware that the endpoints described in Step 6 are an Either/Or choice. You should use either the Save as a new asset endpoint to save the uploaded file as a new asset, or the Update existing asset endpoint to update an existing asset with the uploaded file.

post

Path Parameters

idstringrequired

Asset id to which to save the uploaded file.

Example:00000000-0000-0000-0000-000000000000

importIdstringrequired

Import id of a finalised and processed upload to be saved.

Example:00000000-0000-0000-0000-000000000000

Body

text/plain

Response

201 application/json

Created

post/api/v4/media/{id}/save/{importId}

Body

{}
 
201 application/json

ApiUploadInitResponse

object
multipart_paramsobject
Show Child Parameters
s3_filenamestring

Example:pluploads/api/00000000-0000-0000-0000-000000000000/image.jpeg

s3fileobject
Show Child Parameters
target_keystring

Example:pluploads/api/00000000-0000-0000-0000-000000000000/image.jpeg

Example

ApiV4Upload500Error1

object
messagestring

Example:Could not complete upload

retryinteger

Example:1

successboolean

Example:false

Example

ApiV4UploadResponse

object
batchIdstring

Example:00000000-0000-0000-0000000000000000

fileobject
Show Child Parameters
filenamestring

Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/IMG_1874.JPG

importIdstring

Example:000000000-0000-0000-0000000000000000

locationTypestring

Example:s3

outputstring

Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/

statusstring

Only for chunk registration

Example:ok

successinteger

Example:1

Example

ApiV4UploadResponse1

object
batchIdstring

Example:00000000-0000-0000-0000000000000000

fileobject
Show Child Parameters
filenamestring

Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/IMG_1874.JPG

importIdstring

Example:000000000-0000-0000-0000000000000000

locationTypestring

Example:s3

outputstring

Example:final/2ba07d00-586a-4a44-b13c-c58598cfe828/

successinteger

Example:1

Example