Skip to main content
POST
Create a storage bucket

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

Body

application/json
name
string
required

Unique bucket name (case-insensitive per account).

Required string length: 1 - 128
displayName
string | null
Maximum string length: 256
description
string | null
Maximum string length: 1024
metadata
object | null

Response

Success

object
enum<string>
required
Available options:
bucket
id
string
required

Bucket identifier (buk_*).

name
string
required
isDefault
boolean
required
status
enum<string>
required
Available options:
active,
archived
usedBytes
integer
required
Required range: x >= 0
objectCount
integer
required
Required range: x >= 0
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
displayName
string | null
description
string | null
metadata
object | null