On this page

Installed Add-ons Extensions Subresource

(warning)

Migrate from Preview to v1

Marketplace v1 API is now available, and the Preview API for this Resource will be discontinued in December 2024. See the API Preview to v1 Migration Guide for more information.

This subresource of the Installed Add-ons resource allows users to fetch an Extension, view a list of Extensions, or update an Extension associated with an Installed Add-on Listing. An Extension describes the specific feature or API endpoint of a Twilio product in which an Add-on Listing can be used. Extensions are disabled by default, and can be enabled using Update endpoint.

(information)

Info

This API only supports Add-on Listings that are in General Availability (GA) or Beta state. Listings that are labeled as Coming Soon or Developer Preview are not accessible via the API and must be managed in the Console.

Extension Properties

Property nameTypeRequiredDescriptionChild properties

sidSID<XF>Optional

The unique string that we created to identify the InstalledAddOn Extension resource.

Pattern: ^XF[0-9a-fA-F]{32}$Min length: 34Max length: 34

installed_add_on_sidSID<XE>Optional

The SID of the InstalledAddOn resource to which this extension applies.

Pattern: ^XE[0-9a-fA-F]{32}$Min length: 34Max length: 34

friendly_namestringOptional

The string that you assigned to describe the resource.

product_namestringOptional

The name of the Product this Extension is used within.

unique_namestringOptional

An application-defined string that uniquely identifies the resource.

enabledbooleanOptional

Whether the Extension will be invoked.

urlstring<uri>Optional

The absolute URL of the resource.

Fetch an instance of an Extension for the Installed Add-on.

GET https://marketplace.twilio.com/v1/InstalledAddOns/{InstalledAddOnSid}/Extensions/{Sid}

Path parameters

Property nameTypeRequiredPIIDescription

InstalledAddOnSidSID<XE>required

The SID of the InstalledAddOn resource with the extension to fetch.

Pattern: ^XE[0-9a-fA-F]{32}$Min length: 34Max length: 34

SidSID<XF>required

The SID of the InstalledAddOn Extension resource to fetch.

Pattern: ^XF[0-9a-fA-F]{32}$Min length: 34Max length: 34

This endpoint returns details on a given Extension associated with a given Installed Add-on.

Fetch an Extension

Node.js

Python

C#

Java

Go

PHP

Ruby

twilio-cli

curl


_19// Download the helper library from https://www.twilio.com/docs/node/install
_19const 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
_19const accountSid = process.env.TWILIO_ACCOUNT_SID;
_19const authToken = process.env.TWILIO_AUTH_TOKEN;
_19const client = twilio(accountSid, authToken);
_19
_19async function fetchInstalledAddOnExtension() {
_19  const extension = await client.marketplace.v1
_19    .installedAddOns("XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_19    .extensions("XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_19    .fetch();
_19
_19  console.log(extension.sid);
_19}
_19
_19fetchInstalledAddOnExtension();

Output


_10{
_10  "sid": "XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "installed_add_on_sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "friendly_name": "Incoming Voice Call",
_10  "product_name": "Programmable Voice",
_10  "unique_name": "voice-incoming",
_10  "enabled": true,
_10  "url": "https://marketplace.twilio.com/v1/InstalledAddOns/XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Extensions/XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_10}

Retrieve a list of Extensions for the Installed Add-on.

GET https://marketplace.twilio.com/v1/InstalledAddOns/{InstalledAddOnSid}/Extensions

Path parameters

Property nameTypeRequiredPIIDescription

InstalledAddOnSidSID<XE>required

The SID of the InstalledAddOn resource with the extensions to read.

Pattern: ^XE[0-9a-fA-F]{32}$Min length: 34Max length: 34

Query parameters

Property nameTypeRequiredPIIDescription

PageSizeintegerOptional

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Minimum: 1Maximum: 1000

PageintegerOptional

The page index. This value is simply for client state.

Minimum: 0

PageTokenstringOptional

The page token. This is provided by the API.

This endpoint returns all Extensions associated with a given Installed Add-on.

List multiple Extensions

Node.js

Python

C#

Java

Go

PHP

Ruby

twilio-cli

curl


_18// Download the helper library from https://www.twilio.com/docs/node/install
_18const 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
_18const accountSid = process.env.TWILIO_ACCOUNT_SID;
_18const authToken = process.env.TWILIO_AUTH_TOKEN;
_18const client = twilio(accountSid, authToken);
_18
_18async function listInstalledAddOnExtension() {
_18  const extensions = await client.marketplace.v1
_18    .installedAddOns("XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_18    .extensions.list({ limit: 20 });
_18
_18  extensions.forEach((e) => console.log(e.sid));
_18}
_18
_18listInstalledAddOnExtension();

Output


_22{
_22  "extensions": [
_22    {
_22      "sid": "XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22      "installed_add_on_sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_22      "friendly_name": "Incoming Voice Call",
_22      "product_name": "Programmable Voice",
_22      "unique_name": "voice-incoming",
_22      "enabled": true,
_22      "url": "https://marketplace.twilio.com/v1/InstalledAddOns/XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Extensions/XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_22    }
_22  ],
_22  "meta": {
_22    "page": 0,
_22    "page_size": 50,
_22    "first_page_url": "https://marketplace.twilio.com/v1/InstalledAddOns/XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Extensions?PageSize=50&Page=0",
_22    "previous_page_url": null,
_22    "url": "https://marketplace.twilio.com/v1/InstalledAddOns/XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Extensions?PageSize=50&Page=0",
_22    "next_page_url": null,
_22    "key": "extensions"
_22  }
_22}

Update an Extension for an Add-on installation.

POST https://marketplace.twilio.com/v1/InstalledAddOns/{InstalledAddOnSid}/Extensions/{Sid}

Path parameters

Property nameTypeRequiredPIIDescription

InstalledAddOnSidSID<XE>required

The SID of the InstalledAddOn resource with the extension to update.

Pattern: ^XE[0-9a-fA-F]{32}$Min length: 34Max length: 34

SidSID<XF>required

The SID of the InstalledAddOn Extension resource to update.

Pattern: ^XF[0-9a-fA-F]{32}$Min length: 34Max length: 34

Request body parameters

Encoding type:application/x-www-form-urlencoded

SchemaExample

Property nameTypeRequiredDescriptionChild properties

Enabledbooleanrequired

Whether the Extension should be invoked.

This endpoint updates the data of a given Extension associated with a given Installed Add-on, allowing you to enable or disable the Extension.

Update an Extension

Node.js

Python

C#

Java

Go

PHP

Ruby

twilio-cli

curl


_19// Download the helper library from https://www.twilio.com/docs/node/install
_19const 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
_19const accountSid = process.env.TWILIO_ACCOUNT_SID;
_19const authToken = process.env.TWILIO_AUTH_TOKEN;
_19const client = twilio(accountSid, authToken);
_19
_19async function updateInstalledAddOnExtension() {
_19  const extension = await client.marketplace.v1
_19    .installedAddOns("XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_19    .extensions("XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
_19    .update({ enabled: false });
_19
_19  console.log(extension.sid);
_19}
_19
_19updateInstalledAddOnExtension();

Output


_10{
_10  "sid": "XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "installed_add_on_sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
_10  "friendly_name": "Incoming Voice Call",
_10  "product_name": "Programmable Voice",
_10  "unique_name": "voice-incoming",
_10  "enabled": false,
_10  "url": "https://marketplace.twilio.com/v1/InstalledAddOns/XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Extensions/XFaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
_10}