Volumes

Cloud Storage is managed through app volumes. Volumes give a running app persistent file storage at a mount path, and can expose S3-compatible access when you need direct object workflows.

Features

Persistent volumes

Create a volume for an app, choose the mount path, and set a maximum size. The volume stays with the app across deployments.

S3-enabled access

Turn on s3Enabled when the same storage should be reachable from S3-compatible tooling or object workflows.

Explorer and storage URLs

Volume records expose s3Url and explorerUrl when available, so dashboards and tools can deep-link into stored files.

Redeploy after storage changes

Use redeployApp when changing volume settings should immediately roll the app onto a version with the updated storage mount.

Common workflow

Create the volume with an app ID and mount path.
Update the volume to enable S3 access or adjust settings.
Redeploy the app when the runtime needs the new mount.
List volumes to audit storage attached to the app.

SDK examples

Create an S3-enabled app volume

Create persistent app storage, enable S3 access, print explorer URLs, and list attached volumes.

cloud-storage.jscloud_storage.py

const volume = await client.apps.volumes.create({
  app: "da_XYZ",
  mountPath: "/uploads",
  maxSizeBytes: 1_073_741_824,
});

const updated = await client.apps.volumes.update(volume.id, {
  mountPath: "/uploads",
  s3Enabled: true,
  redeployApp: true,
});

console.log(updated.mountPath, updated.s3Enabled, updated.s3Url);
console.log(updated.explorerUrl);

const volumes = await client.apps.volumes
  .list({ app: "da_XYZ", limit: 10 })
  .autoPagingToArray({ limit: 25 });
console.log(volumes.map((item) => item.mountPath));

from itertools import islice

volume = client.apps.volumes.create(
    app="da_XYZ", mount_path="/uploads", max_size_bytes=1_073_741_824,
)
updated = client.apps.volumes.update(
    volume.id, mount_path="/uploads", s3_enabled=True, redeploy_app=True,
)
print(updated.mount_path, updated.s3_enabled, updated.s3_url)
print(updated.explorer_url)

volumes = list(islice(client.apps.volumes.list(app="da_XYZ", limit=10), 25))
print([item.mount_path for item in volumes])

Source: stackmachine/sdks JavaScript examples.