Register a BYO storage bucket

POST

/v1/storage-buckets

Authorizations

• HTTPBearer
• HTTPBearer
  API_STORAGE

Request Body^required

CreateStorageBucketRequest

object

name

required

Name

string

provider

StorageBucketProvider

Supported object store. Amazon S3 only today. Cloudflare R2, MinIO, and other S3-compatible stores are coming soon.

string

default: S3

Allowed values: S3

auth_mode

StorageBucketAuthMode

Amazon S3 uses OIDC (AssumeRoleWithWebIdentity). Static access keys are not supported for S3.

string

default: OIDC

Allowed values: OIDC

region

Any of:

string

string

null

null

bucket_name

required

Bucket Name

string

endpoint_url

Any of:

string

string

null

null

sts_endpoint_url

Any of:

string

string

null

null

key_prefix

Key Prefix

string

""

role_arn

Any of:

string

string

null

null

external_id

Any of:

string

string

null

null

oidc_subject

Any of:

string

string

null

null

oidc_audience

Any of:

string

string

null

null

access_key_id

Any of:

string

string

null

null

secret_access_key

Any of:

string

string

null

null

is_default

Is Default

boolean

Responses

201

Successful Response

StorageBucket

object

id

required

Id

string

name

required

Name

string

provider

required

StorageBucketProvider

Supported object store. Amazon S3 only today. Cloudflare R2, MinIO, and other S3-compatible stores are coming soon.

string

Allowed values: S3

auth_mode

StorageBucketAuthMode

Amazon S3 uses OIDC (AssumeRoleWithWebIdentity). Static access keys are not supported for S3.

string

default: OIDC

Allowed values: OIDC

region

required

Region

string

bucket_name

required

Bucket Name

string

endpoint_url

Any of:

string

string

null

null

sts_endpoint_url

Any of:

string

string

null

null

key_prefix

Key Prefix

string

""

role_arn

Any of:

string

string

null

null

oidc_subject

Any of:

string

string

null

null

oidc_audience

Any of:

string

string

null

null

access_key_id

Any of:

string

string

null

null

has_secret_access_key

Has Secret Access Key

boolean

status

required

Status

string

is_default

required

Is Default

boolean

dependent_repository_count

Dependent Repository Count

integer

0

last_validated_at

Any of:

string

string

null

null

created_at

Any of:

string

string

null

null

403

Pro subscription required

GenericError

object

detail

Detail

422

Unprocessable Entity

GenericError

object

detail

Detail