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_KEYCopy 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
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | No | Profile ID; mutually exclusive with cloudId. The profile's cloudId is resolved automatically |
cloudId | string | No | Cloud profile ID; use it to clean up leftovers when the local profile is already gone |
provider | string | No | oss or webdav; defaults to the profile's configured provider |
webdav | object | No | WebDAV connection settings; omitted means "use the profile's saved settings" |
webdav.url | string | No | WebDAV endpoint |
webdav.username | string | No | WebDAV user name |
webdav.password | string | No | WebDAV password |
webdav.baseDir | string | No | Base 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
}
}| Field | Type | Description |
|---|---|---|
data.cloudId | string | Cloud profile ID that was removed |
data.provider | string | Storage provider actually used |
data.id | integer | Related 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 neitheridnorcloudIdreturns HTTP400. - Confirm the
cloudIdwith list cloud backups before deleting.



