Skip to main content
POST
Create a share bundle (one link over many objects)

Authorizations

Authorization
string
header
required

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

Path Parameters

bucketId
string
required

Bucket identifier (buk_*).

Body

application/json

Options for a secure share link over a stored object.

objectIds
string<uuid>[]
required

The object ids to bundle into one share link.

Minimum array length: 1

Response

Success

A secure (stateful) share link over a stored object.

object
string
Example:

"share_link"

id
string

Share-link id (shr_*).

objectId
string<uuid>
shareUrl
string

Branded /s/ share page URL (returned only at create time).

downloadUrl
string

Branded /d/ download URL (returned only at create time).

hasPassword
boolean
maxUses
integer | null
oneTime
boolean
usesCount
integer
expiresAt
string<date-time> | null
revoked
boolean
createdAt
string<date-time>