Storage

Create a bucket

POST/v1/workspaces/{workspaceId}/buckets

Creates a smart bucket. Requires an editor role. Provisioning runs after the call; poll the bucket until its phase is active.

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>

workspaceId

string

The workspace id.

name

string

The new bucket name.

provider

string

Storage provider: `gcp` or `r2`.

location

string

Provider region, for example `us-central1`.

search

string

`enabled` or `disabled`. A missing value means `enabled`. Indexes objects for search.