0xDocs 0x.limo

Docs / REST API

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

RouteDoes
GET /v1/apps/{appid}/cloudlist: [{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
bash
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"

#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.

  1. POST /v1/apps/{appid}/cloud_uploads {name, size} → {url}, a pre-signed PUT valid for 10 minutes.
  2. PUT the bytes to url.
  3. POST /v1/apps/{appid}/cloud_commit {name, sha256} checks the hash and makes the file live → {ok, size}. A wrong hash answers 409 sha256 mismatch; nothing uploaded answers 404 nothing staged.

To download, call POST /v1/apps/{appid}/cloud_download {name} → {url}, a pre-signed GET valid for 10 minutes.

bash
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.