Rate this page:

Modifying Configuration for

The Configuration Object detailed below is not directly accessible when using However, all of the same values can be set as ui_attributes using Flex's Configuration REST API.


        Once you have made a GET request to, copy the response and modify any fields you need. You can update any modifiable property on the Configuration resource. To see a full list of properties, see Configuration Resource.


              One field you will often update is ui_attributes. You can use the ui_attributes property to configure Flex UI's functionality, disable plugins, override the current theme, and more. For example, you can set the ui_attributes property to

                "logLevel": "debug",
                "theme": {
                  "isLight": false
                ... // other existing values

              to update the logger's level and disable light theme. Once you've made your changes, POST the new object as your configuration. To see a full list of available properties that can be altered under ui_attributes, see the Flex UI Configuration resource.

              ui_attributes is loaded even for self-hosted deployments of Flex. Any conflicting properties provided in an appConfig configuration object are given precedence when Flex loads.

              Note: When you POST the new object, you might get an error like the below:

                "code": 45004,
                "message": "You are not allowed to modify property for [flex_service_instance_sid, runtime_domain, taskrouter_workspace_sid, service_version, taskrouter_offline_activity_sid, status].",
                "more_info": "",
                "status": 400

              This error indicates that these fields are protected and can't be updated through the API. To successfully POST the updates, please remove these fields from the POST body

              When POST-ing configuration values to ui_attributes, a full JSON object must be provided. This means you should:

              • GET the existing configuration
              • Modify the JSON to add/update/remove your desired properties
              • POST the result as the new configuration
              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.


                    Thank you for your feedback!

                    Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    Refer us and get $10 in 3 simple steps!

                    Step 1

                    Get link

                    Get a free personal referral link here

                    Step 2

                    Give $10

                    Your user signs up and upgrade using link

                    Step 3

                    Get $10

                    1,250 free SMSes
                    OR 1,000 free voice mins
                    OR 12,000 chats
                    OR more