Assets

Bulk upload

POST
/upload/bulk

Generates multiple pre-signed URLs at once. Does not accept duplicate filenames.

Authorization

token_auth
headerAuthorizationBearer <token>

Token-based authentication using access tokens.

Request Body

application/json
  1. body
filenames*array<>

List of original filenames to create pre-signed upload URLs for. Must not contain duplicates.

Items1 <= items <= 200
tags?

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{}

Response Body

Successful Response

application/json
  1. 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"    }  ]}