Skip to main content
POST
Start an object upload

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Headers

Idempotency-Key
string

Optional idempotency key for safe retries of side-effecting operations.

Maximum string length: 128

Path Parameters

bucketId
string
required

Bucket identifier (buk_*).

Body

application/json
filename
string
required
Required string length: 1 - 1024
contentType
string
required
Required string length: 1 - 256
expectedBytes
integer | null

Optional client-declared size; the true size is verified on finalize.

Required range: x >= 0
metadata
object | null

Response

Success

objectId
string<uuid>
required
uploadUrl
string<uri>
required

Presigned S3 PUT URL.

method
enum<string>
required
Available options:
PUT
headers
object
required

Headers that MUST be sent with the PUT (e.g. SSE headers).

expiresInSeconds
integer
required
Required range: 1 <= x <= 604800