Skip to main content
POST
Create

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

orgId
string
required

The organization's id (UUID) or slug — either form is accepted.

Body

application/json
name
string
required

Bucket name: 2-62 chars of lowercase letters, digits, and hyphens, starting with a letter. Unique within the organization.

Pattern: ^[a-z][a-z0-9-]{1,61}$
region
string

Storage area id (see regions.list); defaults to the platform default. Set at creation.

project
string

Project id (UUID) or slug to scope the bucket to. Omitted = organization-level shared bucket.

Response

Bucket created.

id
string
required
name
string
required

Bucket name — unique within the organization.

Pattern: ^[a-z][a-z0-9-]{1,61}$
region
string
required

The bucket's storage area id (see regions.list). Set at creation.

project
string | null
required

Slug of the project the bucket is scoped to; null for an organization-level shared bucket usable from every project.

objectCount
integer
required

Number of objects in the bucket. Refreshed hourly — recent uploads and deletes may not be reflected yet. 0 until the first refresh.

totalBytes
integer
required

Total size of the bucket's objects in bytes. Refreshed hourly, like objectCount.

statsUpdatedAt
string<date-time> | null
required

When objectCount and totalBytes were last refreshed (hourly cadence); null until the first refresh.

createdAt
string<date-time>
required