Storage
S3 (Simple Storage Service) is a scalable, durable, and secure cloud storage service designed for storing and retrieving any amount of data, such as files, backups, or media.
Verified against app.web.cloud.sabay.com (commit bcd97ff4) and the testing
gateway schema on 2026-11-16.
GraphQL Gateway
All Storage operations go through a single GraphQL endpoint:
https://cloud-gateway.sabay.com/graphql
An earlier Storage source wrote this host without a hyphen
(cloudgateway.sabay.com). The verified source uses cloud-gateway.sabay.com,
checked against the frontend and the schema, and it matches the
Run-App gateway.
Authentication
Every request must carry both headers:
| Header | Value |
|---|---|
service-code | cloud_user |
Authorization | Bearer {token} |
Replace {token} with your own access token. Never commit tokens to source
control.
Subscription requirement
Every Storage page in the web app loads the account's cloud_s3 subscription
once, via sb_listSubscription with the filter serviceCode: "cloud_s3", and
uses the first result. If there is no subscription, or its status is
PENDING_SUSPEND or SUSPENDED, the Storage page skips all S3 queries. See
Subscriptions.
Reference
The operations are grouped as follows:
| Section | Contents |
|---|---|
| Buckets | Create, list and delete buckets |
| Credentials | Read and reset your S3 access keys, and read your project name |
| Usage | Summarise storage and network usage |
| Bucket Settings | Per-bucket privacy, policy and CORS configuration |
| Sub-Users | Scoped access keys with permissions on specific buckets |
| Schema-only Operations | Operations in the gateway schema that the web app does not call |
| Upload Files | Connect to a bucket with an S3 client and upload a file (Node.js) |