Create
Create a bucket. Scope it to one project by passing that project’s id or slug, or omit project for an organization-level shared bucket usable from every project. Names follow project-slug rules and are unique per organization.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The organization's id (UUID) or slug — either form is accepted.
Body
Bucket name: 2-62 chars of lowercase letters, digits, and hyphens, starting with a letter. Unique within the organization.
^[a-z][a-z0-9-]{1,61}$Storage area id (see regions.list); defaults to the platform default. Set at creation.
Project id (UUID) or slug to scope the bucket to. Omitted = organization-level shared bucket.
Response
Bucket created.
Bucket name — unique within the organization.
^[a-z][a-z0-9-]{1,61}$The bucket's storage area id (see regions.list). Set at creation.
Slug of the project the bucket is scoped to; null for an organization-level shared bucket usable from every project.
Number of objects in the bucket. Refreshed hourly — recent uploads and deletes may not be reflected yet. 0 until the first refresh.
Total size of the bucket's objects in bytes. Refreshed hourly, like objectCount.
When objectCount and totalBytes were last refreshed (hourly cadence); null until the first refresh.