Uninstall an app install

Changed on Sep 25, 2026

Uninstalls an app from the account that installed it.

post/v1/apps/installs/{id}/uninstall

Request

Base URL
https://api.stripe.com
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/stripe/apis/spec3/docs/v1/apps/installs/:id/uninstall/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Request body application/x-www-form-urlencoded

expandstring[]

Specifies which fields in the response should be expanded.

Response

Successful response.

accountstring required

The ID of the account that the app install belongs to.

appstring required

The ID of the app installed.

approval_requiredboolean required

Whether the installer must authorize pending permissions, content security policy entries, or endpoints. For private apps, approval_required stays false; creating or reauthorizing the install through the API installs the newest completed upload and grants its permissions.

auth_codestring nullable

The authorization code for an oauth app install.

channel'private_live' | 'private_test' | 'public' | 'review' | 'testing' required

The distribution channel associated with the app install.

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

created_bystring nullable

The ID of the embedding platform that created the install, if applicable.

endpoints_grantedstring[] required

The endpoint URLs authorized by the installer.

endpoints_pendingstring[] required

The endpoint URLs requested by the latest app version that the installer has not authorized.

idstring required

Unique identifier for the object.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'apps.install' required

String representing the object's type. Objects of the same type share the same value.

permissions_grantedstring[] required

The permissions authorized by the installer.

permissions_pendingstring[] required

The permissions requested by the latest app version that the installer has not authorized.

status'install_failed' | 'installed' | 'installing' | 'uninstall_failed' | 'uninstalling' required

The status of the app install.

Changes

Sep 25, 20268b5c2f03d4cd Revision changes
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
This list may be incomplete.

Some revisions have not been checked yet.

Operation history