Cloud saves
Per-player, per-app files (ISteamRemoteStorage) — direct reads and writes for small saves, pre-signed uploads with a hash check for large ones.
Each player has a private file space per app. Only that player can read or write it, with their own
token. Names are relative paths with / separators. . and .. segments are refused
(400 bad name).
#Small files
| Route | Does |
|---|---|
GET /v1/apps/{appid}/cloud | list: [{name, size, timestamp}] |
GET /v1/apps/{appid}/cloud/{path} | read the bytes (404 not found) |
PUT /v1/apps/{appid}/cloud/{path} | write the request body → {ok, size} |
DELETE /v1/apps/{appid}/cloud/{path} | delete |
curl -s -X PUT https://api.0x.limo/v1/apps/4000009/cloud/saves/slot1.json \
-H "Authorization: Bearer $TOKEN" --data-binary @slot1.json
curl -s https://api.0x.limo/v1/apps/4000009/cloud/saves/slot1.json -H "Authorization: Bearer $TOKEN"const url = `https://api.0x.limo/v1/apps/${appid}/cloud/saves/slot1.json`;
await fetch(url, { method: "PUT", headers: { Authorization: `Bearer ${token}` }, body: JSON.stringify(save) });
const save2 = await fetch(url, { headers: { Authorization: `Bearer ${token}` } }).then(r => r.json());#Large files
For larger saves, move the bytes with a pre-signed URL. The URL carries its own signature (HMAC-SHA256 over the method, path and expiry), so the upload itself needs no bearer token.
POST /v1/apps/{appid}/cloud_uploads {name, size}→{url}, a pre-signedPUTvalid for 10 minutes.PUTthe bytes tourl.POST /v1/apps/{appid}/cloud_commit {name, sha256}checks the hash and makes the file live →{ok, size}. A wrong hash answers409 sha256 mismatch; nothing uploaded answers404 nothing staged.
To download, call POST /v1/apps/{appid}/cloud_download {name} → {url}, a pre-signed GET
valid for 10 minutes.
API=https://api.0x.limo; H="Authorization: Bearer $TOKEN"
URL=$(curl -s $API/v1/apps/4000009/cloud_uploads -H "$H" -H 'Content-Type: application/json' \
-d "{\"name\": \"world.bin\", \"size\": $(stat -c %s world.bin)}" | jq -r .url)
curl -s -X PUT "$URL" --data-binary @world.bin
curl -s $API/v1/apps/4000009/cloud_commit -H "$H" -H 'Content-Type: application/json' \
-d "{\"name\": \"world.bin\", \"sha256\": \"$(sha256sum world.bin | cut -d' ' -f1)\"}"#Shared files
To share a file with other players, for a leaderboard replay or a Workshop preview, use the shared
file routes: POST /v1/apps/{appid}/shared {name, size} → {handle, url}, upload, then
POST /v1/shared/{id}/commit {sha256}. The upload scanner checks committed files (451 if refused).
Other players read them with GET /v1/shared/{id}.
See the generated apps reference.
