Buckets endpoint

Create, list, and configure storage buckets within a workspace.

Buckets

A bucket is a namespace within a workspace. Buckets carry a name, an optional description, and a versioning policy.

Create a bucket

POST /v1/buckets
Content-Type: application/json

{ "name": "my-bucket", "versioning": "enabled" }

List buckets

GET /v1/buckets

Returns every bucket the calling token can read.

Update a bucket’s policy

PATCH /v1/buckets/{name}
Content-Type: application/json

{ "versioning": "suspended" }

[!WARNING] Suspending versioning does not delete prior versions; it only stops creating new ones. Use the Objects endpoint to clean up.

← Tinybox home