Skip to contentSkip to navigationSkip to topbar
Page tools
Useful for sharing or LLM
Accelerate development with AI
On this page
Looking for more inspiration?Visit the

Service Configuration Resource

The Configuration Resource represents all of the configuration settings for a Conversation Service, such as the default roles assigned to Users.

Configuration Properties

configuration-properties page anchor
Property nameTypeRequiredPIIDescriptionChild properties
chatServiceSidSID<IS>

Optional

Not PII

The unique string that we created to identify the Service configuration resource.

Pattern: ^IS[0-9a-fA-F]{32}$Min length: 34Max length: 34
defaultConversationCreatorRoleSidSID<RL>

Optional

Not PII

The conversation-level role assigned to a conversation creator when they join a new conversation. See Conversation Role for more info about roles.

Pattern: ^RL[0-9a-fA-F]{32}$Min length: 34Max length: 34
defaultConversationRoleSidSID<RL>

Optional

Not PII

The conversation-level role assigned to users when they are added to a conversation. See Conversation Role for more info about roles.

Pattern: ^RL[0-9a-fA-F]{32}$Min length: 34Max length: 34
defaultChatServiceRoleSidSID<RL>

Optional

Not PII

The service-level role assigned to users when they are added to the service. See Conversation Role for more info about roles.

Pattern: ^RL[0-9a-fA-F]{32}$Min length: 34Max length: 34
urlstring<uri>

Optional

Not PII

An absolute API resource URL for this service configuration.

linksobject<uri-map>

Optional

Not PII

Contains an absolute API resource URL to access the push notifications configuration of this service.

reachabilityEnabledboolean

Optional

Not PII

Whether the Reachability Indicator is enabled for this Conversations Service. The default is false.

Fetch a ServiceConfiguration resource

fetch-a-serviceconfiguration-resource page anchor

GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Configuration

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
chatServiceSidSID<IS>
required
Not PII

The SID of the Service configuration resource to fetch.

Pattern: ^IS[0-9a-fA-F]{32}$Min length: 34Max length: 34
Fetch the configuration of a conversation serviceLink to code sample: Fetch the configuration of a conversation service
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID at twilio.com/console

5
// Provision API Keys at twilio.com/console/runtime/api-keys

6
// and set the environment variables. See http://twil.io/secure

7
// For local testing, you can use your Account SID and Auth token

8
const accountSid = process.env.TWILIO_ACCOUNT_SID;

9
const apiKey = process.env.TWILIO_API_KEY;

10
const apiSecret = process.env.TWILIO_API_SECRET;

11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

12


13
async function fetchServiceConfiguration() {

14
  const configuration = await client.conversations.v1

15
    .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")

16
    .configuration()

17
    .fetch();

18


19
  console.log(configuration.chatServiceSid);

20
}

21


22
fetchServiceConfiguration();

Response

Note about this response
1
{

2
  "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

3
  "default_conversation_creator_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

4
  "default_conversation_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

5
  "default_chat_service_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

6
  "reachability_enabled": false,

7
  "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration",

8
  "links": {

9
    "notifications": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration/Notifications",

10
    "webhooks": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration/Webhooks"

11
  }

12
}

Update a ServiceConfiguration resource

update-a-serviceconfiguration-resource page anchor

POST https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Configuration

Path parameters

path-parameters-1 page anchor
Property nameTypeRequiredPIIDescription
chatServiceSidSID<IS>
required
Not PII

The SID of the Service configuration resource to update.

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

Request body parameters

request-body-parameters page anchor
Encoding type:application/x-www-form-urlencoded
SchemaExample
Property nameTypeRequiredPIIDescriptionChild properties
defaultConversationCreatorRoleSidSID<RL>

Optional

Not PII

The conversation-level role assigned to a conversation creator when they join a new conversation. See Conversation Role for more info about roles.

Pattern: ^RL[0-9a-fA-F]{32}$Min length: 34Max length: 34
defaultConversationRoleSidSID<RL>

Optional

Not PII

The conversation-level role assigned to users when they are added to a conversation. See Conversation Role for more info about roles.

Pattern: ^RL[0-9a-fA-F]{32}$Min length: 34Max length: 34
defaultChatServiceRoleSidSID<RL>

Optional

Not PII

The service-level role assigned to users when they are added to the service. See Conversation Role for more info about roles.

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

Optional

Not PII

Whether the Reachability Indicator is enabled for this Conversations Service. The default is false.

Update configuration settings of a conversation serviceLink to code sample: Update configuration settings of a conversation service
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID at twilio.com/console

5
// Provision API Keys at twilio.com/console/runtime/api-keys

6
// and set the environment variables. See http://twil.io/secure

7
// For local testing, you can use your Account SID and Auth token

8
const accountSid = process.env.TWILIO_ACCOUNT_SID;

9
const apiKey = process.env.TWILIO_API_KEY;

10
const apiSecret = process.env.TWILIO_API_SECRET;

11
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

12


13
async function updateServiceConfiguration() {

14
  const configuration = await client.conversations.v1

15
    .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")

16
    .configuration()

17
    .update({

18
      defaultConversationCreatorRoleSid: "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

19
    });

20


21
  console.log(configuration.chatServiceSid);

22
}

23


24
updateServiceConfiguration();

Response

Note about this response
1
{

2
  "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

3
  "default_conversation_creator_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

4
  "default_conversation_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

5
  "default_chat_service_role_sid": "RLaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

6
  "reachability_enabled": false,

7
  "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration",

8
  "links": {

9
    "notifications": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration/Notifications",

10
    "webhooks": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration/Webhooks"

11
  }

12
}