Create a storage mount

Create a new object storage mount from a cloud bucket or local source

POST

/auth/v1/seed/{namespace}/storage

curl --request POST \
  --url /auth/v1/seed/{namespace}/storage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"model-weights","storage_type":"s3","cloud":"aws","region":"us-east-1","bucket":"acme-model-weights","mode":"mount"}'

Path parameters

namespace

string

required

The namespace (user or organization) to create the storage mount in.

Body parameters

name

string

required

A unique name for the storage mount within the namespace. Allowed characters: alphanumeric, hyphens, underscores.

storage_type

string

required

Object storage backend. One of `s3`, `gcs`, `azure_blob`.

cloud

string

required

Cloud provider. One of `aws`, `azure`, `gcp`.

region

string

required

Cloud region where the bucket resides (e.g., `us-east-1`, `westus2`, `europe-west1`).

bucket

string

Name of an existing cloud bucket to mount. Either `bucket` or `source` must be provided.

source

string

Local path to sync to cloud storage. Either `bucket` or `source` must be provided.

mode

string

Access mode. `mount` streams data directly from the bucket. `copy` downloads data locally before the workload starts.

default: mount

You can also create a storage mount from a local source path:

Previous → Repositories

Next List storage mounts →