Upload
Bulk upload
POST
Generates multiple pre-signed URLs at once. Does not accept duplicate filenames.
token_authheader
AuthorizationBearer <token>Token-based authentication using access tokens.
application/json- body
filenames*array<>List of original filenames to create pre-signed upload URLs for. Must not contain duplicates.
Items
1 <= items <= 200tags?Tag assignments keyed by filename. Every key must also appear in filenames.
Default
{}notes?Styling notes keyed by filename. Every key must also appear in filenames.
Default
{}derived_from?Lineage keyed by filename: the asset each file was cropped from in the app
(crop-to-item). Recorded on the new asset; the original is never changed.
Every key must also appear in filenames.
Default
{}Successful Response
application/json- response
uploads*array<>Upload URL payloads generated for each requested filename.
curl -X POST "https://example.com/upload/bulk" \ -H "Content-Type: application/json" \ -d '{ "filenames": [ "string" ] }'{ "uploads": [ { "upload_url": "string", "download_url": "string", "file_id": "string", "filename": "string", "content_type": "string" } ]}