Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Path Parameters

storage_id
integer<int64>
required

Storage ID

Body

application/json

BucketCreateBodyV4 Request body for creating a bucket. The optional CORS, lifecycle and policy blocks use the same shapes as the PATCH body and are applied as part of creation.

name
string
required

Name of the bucket to create

Example:

"my-new-bucket"

cors
BucketCORSPatchV4 Update CORS origins browsers can use for requests to this bucket. Empty array removes CORS. · object
lifecycle
BucketLifecyclePatchV4 Update automatic object expiration. Set expiration_days to enable, or null/0 to remove. · object
policy
BucketPolicyPatchV4 Update public access. Set is_public to true to allow unauthenticated reads, false to require authentication. · object

Response

BucketDetailResV4

cors
BucketCORSV4 CORS settings controlling which web domains can access objects in this bucket from a browser. · object
required
lifecycle
BucketLifecycleV4 Automatic object expiration rule. Objects are permanently deleted after the specified number of days. · object
required
name
string
required

Globally unique bucket name within the storage. Used as the path prefix when accessing objects via S3 API.

Example:

"my-bucket"

policy
BucketPolicyV4 Access policy controlling whether objects in this bucket can be read without authentication. · object
required
storage_id
integer<int64>
required

Parent storage this bucket belongs to. Use this ID in the URL path for bucket operations.

Example:

123