Enable Flex UI 2.x.x on your account

Flex UI 2.x.x is now in General Availability. You can install it by accessing the Versioning and updates page of your Flex app Admin Dashboard. If you are running a 1.x.x version, select 2.x.x and click Confirm. If you are on a Public Beta version of 2.x.x, install 2.x.x by clicking on the 2.x.x version link and then Install. Your application will now be upgraded to Flex UI 2.x.x.

To change the ui_version and reset your ui_dependencies, you can make the following curl request. Change the version number in this curl request (2.x.x) to the current version number that you're migrating to. You can retrieve your account SID and auth token from the Twilio Console.

1
curl --request POST \
2
 --url https://flex-api.twilio.com/v1/Configuration \
3
 -u ACXXXXXXXXXXXXXXXXXXXXX:auth_token \
4
 --header 'accountsid: ACXXXXXXXXXXXXXXXXXXXXX' \
5
 --header 'content-type: application/json' \
6
 --header 'i-twilio-auth-account: ACXXXXXXXXXXXXXXXXXXXXX' \
7
 --data '{
8
   "account_sid": "ACXXXXXXXXXXXXXXXXXXXXX",
9
   "ui_version": "~2.x.x",
10
   "ui_dependencies": {}
11
}'

You can install Flex UI 2.x.x via yarn or npm:

yarn add @twilio/flex-ui@^2

1
npm install @twilio/flex-ui@^2
2

Refer to Upgraded dependencies if you run into compatibility issues which you will need to resolve.

To use the flex-ui-sample package for bootstrapping your project, make sure to pull the latest from the main branch of the flex-ui sample repo which requires the @twilio/flex-ui@^2 package. We have also bumped React to version 17 to satisfy the Flex 2.x.x requirements. This means that on any existing project, you have to resolve compatibility issues in your code should they occur.