Skip to main content
POST
Initiate Chunked Upload

Authorizations

Authorization
string
header
required

JWT in Authorization header. 'Bearer ' prefix optional.

Body

application/json
directory_id
string<uuid>
required

ID of the directory this asset belongs to

name
string
required

Filename including extension

size_bytes
integer
required

Total file size in bytes

id
string<uuid> | null

Client-generated asset ID (optional, server generates if not provided)

auto_rename
enum<string> | null

Auto-rename style to use if name conflicts with an existing item. If not set and a conflict exists, returns 409.

Available options:
parenthesized,
numeric
conflict_resolution
enum<string> | null

How to handle name conflicts. 'replace': trash existing asset, create new. 'skip': skip this item if a conflict exists (no asset created). Mutually exclusive with auto_rename.

Available options:
replace,
skip

Response

Successful Response

result
ChunkedUploadInitiateResponse · object | null

API response schema for initiating a chunked upload

error
string | null
skipped
boolean | null