Uninstall a catalogue app
curl --request DELETE \
--url https://my.server.express/api/v1/cloud/{id}/app-installs/{installId} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://my.server.express/api/v1/cloud/{id}/app-installs/{installId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.server.express/api/v1/cloud/{id}/app-installs/{installId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"success": true,
"data": {
"slug": "<string>",
"purged": true,
"warning": "<string>"
}
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}Cloud
Uninstall a catalogue app
Stops the app on the server and removes its directory. Docker volumes (the app’s data) survive unless purge=1. If the
VM can’t be reached the install is still marked REMOVED and warning says so. Session auth only; needs the operate role.
403 while PENDING/SUSPENDED; 409 if already removed. Writes an UNINSTALL_CLOUD_APP audit entry.
DELETE
/
v1
/
cloud
/
{id}
/
app-installs
/
{installId}
Uninstall a catalogue app
curl --request DELETE \
--url https://my.server.express/api/v1/cloud/{id}/app-installs/{installId} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://my.server.express/api/v1/cloud/{id}/app-installs/{installId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.server.express/api/v1/cloud/{id}/app-installs/{installId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"success": true,
"data": {
"slug": "<string>",
"purged": true,
"warning": "<string>"
}
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}{
"success": false,
"error": "<string>"
}Authorizations
Session access token (JWT) from POST /v1/auth/login or /v1/auth/refresh. A session satisfies every API scope.
Query Parameters
Set to 1 to delete the app's Docker volumes as well. Any other value keeps them.
Available options:
1