Uninstall app

POST/marketplace/apps/{id}/uninstall

Removes an installed app from the tenant workspace, executing the app's uninstall lifecycle hook. Data created by the app is not automatically removed; refer to the app's documentation for data retention handling.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the app to uninstall.

Request body

Content type application/json.

Field	Type	Required	Description
reason	string	No	Optional reason for uninstalling the app, logged for analytics. Max length: 500

Example

{
  "reason": "Switching to a custom-built Slack integration."
}

Responses

200 App uninstalled and install lifecycle hook executed

404 App not found or not currently installed

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/marketplace/apps/{id}/uninstall" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Switching to a custom-built Slack integration."}'