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

application/x-www-form-urlencoded

Body

  • DefaultChatServiceSid string

    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}$.

  • DefaultClosedTimer string

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

  • DefaultInactiveTimer string

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

  • DefaultMessagingServiceSid string

    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

  • • 200

    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}$.

    • default_chat_service_sid string | null

      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_closed_timer string | null

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

    • default_inactive_timer string | null

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

    • default_messaging_service_sid string | null

      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}$.

    • links object(uri-map) | null

      Absolute URLs to access the webhook and default service configurations.

    • 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"
}
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"
}