Skip to content

Asset Files

An AssetFile describes a version of a file for an Asset. Properties describe details of the file such as mediaType and dimensions (for images and videos). A previewUrl provides a means to access previews of the AssetFile

The current AssetFile for an Asset is returned with the Asset resource.

The AssetFile.id can be provided when creating an AssetDownload to download a specific AssetFile for an Asset.

An AssetUpload resource is created when you want to upload a file to an Asset. Upon completion a new AssetFile is created and will subsequently be returned in Asset.currentAssetFile. You can use GET Asset Files to retrieve the all AssetFile resources for an Asset.

The AssetUpload resource defines one or more URLs to which parts of the file should be PUT to.

Below is an example CURL PUT request that could be used to upload a local file part to an upload part URL taken from an AssetUpload:

curl --request PUT '<UPLOAD_PART_URL>' \
--header 'Content-Length: <SIZE_OF_PART>' \
--header 'Content-Type: <FILE_CONTENT_TYPE>' \
--data '@<PATH_TO_FILE_PART>'

The upload is then completed by sending a list of the eTags returned from each of these PUTs to AssetUploadComplete