Upload a file

Storage

Description

Upload a file to temporary storage. The file is validated based on the usage type
(e.g. format, size, aspect ratio). Returns a file URL that can be used when creating
or updating resources.

Request Body

required

`multipart/form-data`

filestring (binary)required

The file to upload

usage_typestringrequired

The intended usage for the file. Determines validation rules. - `product.image`: JPEG, PNG or WebP, max 1 MB, must be square (1:1 ratio)

Example: product.image

Responses

201 File uploaded successfully

application/json

statusstring

Example: success

dataobject

401 Not authenticated

application/json

403 Missing required feature flag

application/json

422 Validation error (unsupported format, file too large, wrong aspect ratio)

application/json