apps

Uninstall an app

Changed on Oct 28, 2026

Remove the organization's installation of an app (org admins only, from an interactive session: an API key is refused). The removal can be held to the installation the caller last read: expected_settings and expected_installed_at name what it held, and an installation that holds anything else is left in place and answered 409, so a request made before the app was connected again never removes the new connection. The app's integration session, when it holds one, is revoked with the removal, never apart from it.

delete/apps/{app_id}

Request

Base URL
https://api.sparkvault.com/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/apps/:app_id/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

app_idstring required

The app, by its catalog id.

Request body

expected_settingsobject

The installation's settings as last read: each must hold exactly this value, a setting the installation lacks comparing as null. Omitted, the settings are not compared.

expected_installed_atinteger

Unix seconds the installation was made, as last read. Omitted, it is not compared.

Response

The installation is removed.

Changes

Oct 28, 2026a9a10e328ba5 Revision changes
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Oct 28, 202656d7c265a77a Revision changes
- info
  added optional request body
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the success response with the status

Operation history (3 revisions)