Skip to content

Delete cloud backup ​

Removes a profile's cloud backup. Three things are cleared together: the profile package, the credential envelope, and the cloud ID registration. The local profile is untouched, but it can no longer be restored from the cloud.

Reference: POST · verified 2026-11-19.

Request ​

http
POST /api/deleteCloudBackup
api-key: REPLACE_WITH_LOCAL_API_KEY

Copy the local service address and api-key from the client's API page; the port is assigned dynamically and is not the browser CDP port. See Overview and authentication.

JSON body ​

FieldTypeRequiredDescription
idintegerNoProfile ID; mutually exclusive with cloudId. The profile's cloudId is resolved automatically
cloudIdstringNoCloud profile ID; use it to clean up leftovers when the local profile is already gone
providerstringNooss or webdav; defaults to the profile's configured provider
webdavobjectNoWebDAV connection settings; omitted means "use the profile's saved settings"
webdav.urlstringNoWebDAV endpoint
webdav.usernamestringNoWebDAV user name
webdav.passwordstringNoWebDAV password
webdav.baseDirstringNoBase directory, such as /

Provide at least one of id and cloudId. OSS-only cleanups do not need webdav.

cURL ​

bash
BASE_URL='http://127.0.0.1:REPLACE_WITH_API_PORT'
API_KEY='REPLACE_WITH_LOCAL_API_KEY'
curl --request POST "${BASE_URL}/api/deleteCloudBackup" \
  --header "api-key: ${API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1,
  "provider": "oss"
}'

Cleanup by cloudId when the local profile no longer exists:

bash
curl --request POST "${BASE_URL}/api/deleteCloudBackup" \
  --header "api-key: ${API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "cloudId": "0f1e2d3c-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "provider": "oss"
}'

Response ​

json
{
  "success": true,
  "data": {
    "cloudId": "0f1e2d3c-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "provider": "oss",
    "id": 1
  }
}
FieldTypeDescription
data.cloudIdstringCloud profile ID that was removed
data.providerstringStorage provider actually used
data.idintegerRelated local profile ID; may be 0 when deleting by cloudId with no local match

Notes ​

  • This is irreversible. To stop future uploads while keeping existing backups, call set cloud sync with enable: false.
  • Only the cloud copy is removed; the local profile and its data directory are untouched. To delete locally, use delete profile.
  • Signed-out or expired-membership calls return HTTP 403; passing neither id nor cloudId returns HTTP 400.
  • Confirm the cloudId with list cloud backups before deleting.