Update the global configuration of conversations on your account

POST /v1/Configuration

The Configuration resource manages a set of account-level settings applicable to the Conversations API.

Update the global configuration of conversations on your account

Body

  • The SID of the default Conversation Service to use when creating a conversation.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.

  • Default ISO8601 duration when conversation will be switched to closed state. Minimum value for this timer is 10 minutes.

  • Default ISO8601 duration when conversation will be switched to inactive state. Minimum value for this timer is 1 minute.

  • The SID of the default Messaging Service to use when creating a conversation.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^MG[0-9a-fA-F]{32}$.

Responses

  • OK

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account responsible for this configuration.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • The SID of the default Conversation Service that every new conversation is associated with.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IS[0-9a-fA-F]{32}$.

    • Default ISO8601 duration when conversation will be switched to closed state.

    • Default ISO8601 duration when conversation will be switched to inactive state.

    • The SID of the default Messaging Service that every new conversation is associated with.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^MG[0-9a-fA-F]{32}$.

    • url string(uri) | null

      An absolute URL for this global configuration.

POST /v1/Configuration
curl \
 -X POST https://conversations.twilio.com/v1/Configuration \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'DefaultChatServiceSid=string&DefaultClosedTimer=string&DefaultInactiveTimer=string&DefaultMessagingServiceSid=string'
Request example
{
  "DefaultChatServiceSid": "string",
  "DefaultClosedTimer": "string",
  "DefaultInactiveTimer": "string",
  "DefaultMessagingServiceSid": "string"
}
Request examples
{
  "DefaultChatServiceSid": "string",
  "DefaultClosedTimer": "string",
  "DefaultInactiveTimer": "string",
  "DefaultMessagingServiceSid": "string"
}
Response examples (200)
{
  "account_sid": "string",
  "default_chat_service_sid": "string",
  "default_closed_timer": "string",
  "default_inactive_timer": "string",
  "default_messaging_service_sid": "string",
  "links": {},
  "url": "https://example.com"
}
Response examples (200)
{
  "account_sid": "string",
  "default_chat_service_sid": "string",
  "default_closed_timer": "string",
  "default_inactive_timer": "string",
  "default_messaging_service_sid": "string",
  "links": {},
  "url": "https://example.com"
}