AppHub Tether — CloudStore
CloudStore Set
Saves or overwrites a JSON value in the cloud, scoped to the currently logged-in AppHub user and your app. The launcher injects the user token automatically — your app only needs its own AppID:AppKey.
POST
http://127.0.0.1:7420/cloudstore/set
Requires
Authorization: AppID:AppKey — launch token alone is not accepted. See CloudStore Authentication
This endpoint requires AppHub Store to be running on your machine. The live tester calls your local AppHub instance directly.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| cloudkey | string | required | Name/key for this data (e.g. "save-slot-1", "settings") |
| dataobject | any | required | Any JSON-serializable value — object, array, string, or number. Completely overwrites any existing value for this key. |
Test this endpoint
Headers
Body
Success response 200
{
"ok": true,
"success": true,
"message": "Cloud data saved successfully.",
"cloudkey": "save-slot-1"
}Errors
| Reason | Cause |
|---|---|
missing_fields | cloudkey or dataobject not provided |
missing_app_credentials | Authorization: AppID:AppKey header not sent |
no_account | No user is logged in to AppHub — prompt user to sign in via the launcher |
invalid_json | Request body is not valid JSON |
upstream_error | CloudStore API returned an error |