Skip to contentSkip to navigationSkip to topbar
Rate this page:
On 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:


_10
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

accountconfig-properties page anchor
Property nameTypePIIDescription
keystring
Not PII

The config key; up to 100 characters.


date_updatedstring<date-time>

valuestring

The config value; up to 4096 characters.


urlstring<uri>

The absolute URL of the Config.


Create an account-level Config

create-an-account-level-config page anchor
POST https://microvisor.twilio.com/v1/Configs

Request body parameters

request-body-parameters page anchor
Property nameTypeRequiredPIIDescription
Keystringrequired

The config key; up to 100 characters.


Valuestringrequired

The config value; up to 4096 characters.

Create an account-level Config

create-an-account-level-config-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_19
// Download the helper library from https://www.twilio.com/docs/node/install
_19
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_19
_19
// Find your Account SID and Auth Token at twilio.com/console
_19
// and set the environment variables. See http://twil.io/secure
_19
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_19
const authToken = process.env.TWILIO_AUTH_TOKEN;
_19
const client = twilio(accountSid, authToken);
_19
_19
async function createAccountConfig() {
_19
const accountConfig = await client.microvisor.v1.accountConfigs.create({
_19
key: "key_name",
_19
value: "value",
_19
});
_19
_19
console.log(accountConfig.key);
_19
}
_19
_19
createAccountConfig();

Output

_10
{
_10
"key": "key_name",
_10
"value": "value",
_10
"date_updated": "2021-01-01T12:34:56Z",
_10
"url": "https://microvisor.twilio.com/v1/Configs/first"
_10
}


Retrieve an account-level Config

retrieve-an-account-level-config page anchor
GET https://microvisor.twilio.com/v1/Configs/{Key}

Property nameTypeRequiredPIIDescription
Keystringrequired

The config key; up to 100 characters.

Fetch an account-level Config

fetch-an-account-level-config page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_18
// Download the helper library from https://www.twilio.com/docs/node/install
_18
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_18
_18
// Find your Account SID and Auth Token at twilio.com/console
_18
// and set the environment variables. See http://twil.io/secure
_18
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18
const authToken = process.env.TWILIO_AUTH_TOKEN;
_18
const client = twilio(accountSid, authToken);
_18
_18
async function fetchAccountConfig() {
_18
const accountConfig = await client.microvisor.v1
_18
.accountConfigs("Key_name")
_18
.fetch();
_18
_18
console.log(accountConfig.key);
_18
}
_18
_18
fetchAccountConfig();

Output

_10
{
_10
"key": "Key_name",
_10
"value": "place",
_10
"date_updated": "2021-01-01T12:34:57Z",
_10
"url": "https://microvisor.twilio.com/v1/Configs/first"
_10
}


Delete an account-level Config

delete-an-account-level-config page anchor
DELETE https://microvisor.twilio.com/v1/Configs/{Key}

Property nameTypeRequiredPIIDescription
Keystringrequired

The config key; up to 100 characters.

Delete an account-level Config

delete-an-account-level-config-1 page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_14
// Download the helper library from https://www.twilio.com/docs/node/install
_14
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_14
_14
// Find your Account SID and Auth Token at twilio.com/console
_14
// and set the environment variables. See http://twil.io/secure
_14
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_14
const authToken = process.env.TWILIO_AUTH_TOKEN;
_14
const client = twilio(accountSid, authToken);
_14
_14
async function deleteAccountConfig() {
_14
await client.microvisor.v1.accountConfigs("key_name").remove();
_14
}
_14
_14
deleteAccountConfig();


Rate this page: