Create asset
POST /assets
Creates an asset and returns a presigned URL for uploading its associated file. Returns a 422 error if quota limits are exceeded.
To upload the file, perform a PUT request to the returned upload URL with the following headers: Content-Type, Content-Length, and x-amz-checksum-sha256, using the same values as those provided in the asset creation request.
The file must be uploaded and validated using the complete operation within 60 minutes of asset creation.
Request body✻
Content application/json
Properties
appIdstringchecksumstring✻The base64 encoded, 256-bit SHA256 digest of the asset file.
44..44 charactersExample
"PMn3M4bMd4BMeNhBEDZNQLYxOa6l0luM+IrDA3pZlpY="contentTypestring✻filenamestring✻sizeinteger✻The size of the asset file in bytes. Must be a positive integer not exceeding 20 MiB.
<=20971520>=1Examples
10245242880
Responses
201Created
Content application/json
Properties
idstring✻appIdstring✻userIdstring✻storageKeystring✻checksumstring✻The base64 encoded, 256-bit SHA256 digest of the asset file.
44..44 charactersExample
"PMn3M4bMd4BMeNhBEDZNQLYxOa6l0luM+IrDA3pZlpY="contentTypestring✻filenamestring✻sizeinteger✻The size of the asset file in bytes. Must be a positive integer not exceeding 20 MiB.
<=20971520>=1Examples
10245242880statusstring✻The asset is awaiting upload completion and cannot be downloaded until the upload process is complete.
"uploadable"uploadUrlstring✻A presigned URL for upload or download operations expiring after 60 minutes.
format: uriExample
"https://object-storage.hedia.com/bucket/key?X-Amz-Expires=3600&X-Amz-Signature=signature"createdobject✻Information about the creation of an entity.
Properties
atstring✻byobject✻Properties
id✻typestring✻"app""system""user"
updatedobjectInformation about the update of an entity.
Properties
atstring✻byobject✻Properties
id✻typestring✻"app""system""user"
Security
Servers
asset.hedia.comhttps://asset.hedia.com/api/v1