Assets - Content
Upload, download, delete, replace, and manage asset files. Each uploaded file creates a new asset with a unique 32-character alphanumeric UUID.
Key concepts:
- Deleting an
originalis a soft-delete (asset is hidden, can be restored) - Purging permanently removes the asset and all conversions
- Public access can be set per-file or per-conversion
📄️ Upload Asset
Use this API to upload one or more files and create assets within FileSpin.
📄️ Ingest from URI
Use of this API to request FileSpin to retrieve a file from external HTTP URL or a S3 Bucket and create an asset.
📄️ Replace Asset Content
API to replace the original content file of an asset while keeping the Asset ID unchanged.
📄️ Download
Use this API to retrieve the original file or a pre-defined image conversion or a video transcode. HTTP Range header can also be used to retrieve large file as multiple parts.
📄️ Delete
API to delete an asset or it's conversions. Deleting the `original` is a soft-delete within FileSpin. It will mark Asset as deleted and hide it from view (See Purge API to completely purge an Asset). Asset administrators can retrieve deleted Assets using Search API by setting `trashed` option to true. Unknown custom keys and keys that do not apply to the file type will be ignored
📄️ Delete - Bulk
API to delete assets in bulk. This soft deletes the asset which marks the original as deleted and removes all conversions and addons for an asset.
📄️ Undelete
API to undelete an asset that has been deleted.
📄️ Purge Deleted Assets
**This is a ADMIN-only API**
📄️ Set Public Access
This API can be used to set public-read access to a file or its conversions in the Cloud Storage (such as S3).
📄️ Upload signed url
Upload signed url
📄️ Bulk Purge - Request
Request a bulk purge of trashed assets.
📄️ Bulk Purge - Get Count
Get the count of assets that would be affected by a bulk purge operation.
📄️ Bulk Purge - Get Pending
Get pending bulk purge requests.
📄️ Bulk Purge - Confirm
Confirm and execute a pending bulk purge request.
📄️ Stream ZIP Download
Download multiple assets as a streamed ZIP archive.