Apps

Uninstall app

Uninstall an app from a Cloud instance.

POST/apps/installed/{installed_app_id}/uninstall

Uninstall an app from the instance it was installed on. Blnk tells the registration callback, then revokes the API key when that callback returns 2xx.

An admin or a member can call this.

Enterprise authentication

Send these requests to https://api.cloud.blnkfinance.com on Blnk Cloud. On a self-hosted Enterprise deployment, send them to ENTERPRISE_PUBLIC_URL.

Pass an Enterprise API key, or an OAuth access token, in the X-blnk-key header. Create the key in Enterprise API keys, or issue a token with OAuth.

This credential comes from the Cloud or Enterprise workspace. A Core API key belongs to the Core instance.

X-blnk-keystringrequiredheader

Enterprise API key, or an OAuth access token.

Path

installed_app_idstringrequiredpath

Id of the installation from Install app or List apps (instapp_...).

Response

A 200 response returns a confirmation.

messagestringrequired

App uninstalled successfully.

curl -X POST "https://api.cloud.blnkfinance.com/apps/installed/instapp_8cc22560-5ace-4989-8953-fcbad7947d48/uninstall" \
  -H "X-blnk-key: CLOUD_API_KEY"

{
  "message": "App uninstalled successfully"
}

{
  "error": "installed app with id 'instapp_8cc22560-5ace-4989-8953-fcbad7947d48' not found"
}

{
  "error": "installed app with id 'instapp_8cc22560-5ace-4989-8953-fcbad7947d48' not found or already uninstalled"
}

{
  "error": "uninstall handshake failed: uninstall callback returned status 500"
}

{
  "error": "User not authenticated"
}

{
  "error": "Organization not found"
}