Buckets

Create a bucket

POST/v1/workspaces/{workspaceId}/buckets

Reserves the name and starts provisioning. Poll the bucket phase or the job.

Authentication

Send your Spark API key with every request. The value is the full bearer token Spark returned when you created the key. See Authentication.

Authorization: Bearer <SPARK_API_KEY>

Path parameters

workspaceId

string

The workspace id.

Request body

name

string

Customer bucket name.

provider

StorageProvider (optional)

Object store that holds the bucket bytes. One of: aws, gcp, azure, r2.

location

string (optional)

Defaults to us. One of: us, eu, asia.

storageClass

string (optional)

Defaults to standard. One of: standard, nearline, coldline, archive.

Was this page helpful?