startUpdateFlow()

Starts the flow to update an installed app to its latest released version. If the update requires new permissions, a consent modal opens. Otherwise, a loader modal opens and the app version updates.

Permissions modal for updating

Important: This method is only available in the editor.

Method declaration

Copy

Parameters

NameTypeDescription
argsUpdateFlowRequestConfiguration options for updating the app.

UpdateFlowRequest

NameTypeDescription
appIdstringRequired. The ID of the app to update.

Returns

Copy

A promise that resolves to an UpdateFlowResponse indicating the result of the update attempt.

UpdateFlowResponse

NameTypeDescription
statusstringStatus indicating that the update completed or explaining why it didn't. Possible values:
  • SUCCESS: Update completed successfully.
  • CANCELED: The Wix user canceled the update process.
installedAppsInstalledApp[]Array of updated apps. Includes the target app and any apps that were also installed or updated because they're dependencies for it. The response includes this field only if status is SUCCESS.

InstalledApp

NameTypeDescription
appIdstringThe ID of the updated app.
versionstringThe new version of the updated app.

Examples

Update an app

Copy

Errors

This method may return the following error codes:

  • NOT_INSTALLED: The app isn't installed. Apps must be installed before they can be updated.
  • ALREADY_UP_TO_DATE: The app is already up to date.
Did this help?