Menu

Expand
Rate this page:

Config resource

You can provide configuration data for multiple Microvisor-empowered IoT devices using the Config resource. Configs are intended as a way to upload data such as API keys, PKI certificates, and other items to the Twilio cloud so they need not be baked into application code. Instead, the application code running on the device retrieves the Config when it needs the information.

Each Config is a key:value pair which your application code can access using Microvisor System Calls.

Keys are text identifiers of up to 100 characters in length. They must be unique for a given account.

Values must also be supplied as text, of up to 4096 characters in length. If you wish to make binary data available to your devices, you will need to encode it as text before creating the Config. For example, you might used base64 encoding. Your application must decode the value back to binary after acquiring it from the Twilio cloud.

Config resources are accessed at this endpoint:

https://microvisor.twilio.com/v1/Configs

Config resources are accessible from all devices associated with an account. For Configs that are made available to specific devices, please see Device Configs.

It is possible for anyone with account access to read back the value of any Config. If you have information which, once created, you would not like to be accessible to other account holders, use Secrets, which are, from the API perspective, write- and delete-only.

AccountConfig properties

Resource Properties in REST API format
key
string Not PII

The config key; up to 100 characters.

date_updated
date_time<iso8601> Not PII

value
string Not PII

The config value; up to 4096 characters.

url
url Not PII

The absolute URL of the Config.

Create an account-level Config

post
https://microvisor.twilio.com/v1/Configs
Parameters
Parameters in REST API format
key
Required
post string Not PII

The config key; up to 100 characters.

value
Required
post string Not PII

The config value; up to 4096 characters.

Example 1
Loading Code Sample...
        
        

        Create an account-level Config

        Retrieve an account-level Config

        get
        https://microvisor.twilio.com/v1/Configs/{Key}
        Parameters
        Parameters in REST API format
        key
        Path
        get string Not PII

        The config key; up to 100 characters.

        Example 1
        Loading Code Sample...
              
              

              Fetch an account-level Config

              Delete an account-level Config

              delete
              https://microvisor.twilio.com/v1/Configs/{Key}
              Parameters
              Parameters in REST API format
              key
              Path
              delete string Not PII

              The config key; up to 100 characters.

              Example 1
              Loading Code Sample...
                    
                    

                    Delete an account-level Config

                    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.

                    Loading Code Sample...
                          
                          
                          

                          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!

                          thanks-feedback-gif