Update an app install

Changed on

Reauthorizes an app install. The installer grants the permissions, content security policy entries, and endpoints that the version being installed requests. An account reauthorizes its own installs on any channel with its own key; app developers and embedding platforms reauthorize installs on connected accounts through Stripe-Account. For private apps, the version being installed is the newest completed upload.

post/v1/apps/installs/{id}

Request

  • Base URL: https://api.stripe.com
  • URL: https://api.stripe.com/v1/apps/installs/{id}
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Path parameters

idstring required

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

  • 8b5c2f03d4cdRevision 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.