Update the global configuration of conversations on your account

POST /v1/Configuration
Account sid auth token

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

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

  • DefaultInactiveTimer string

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

  • DefaultClosedTimer string

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

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    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 used 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_messaging_service_sid string | null

      The SID of the default Messaging Service used when creating a conversation.

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

    • default_inactive_timer string | null

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

    • default_closed_timer string | null

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

    • url string(uri) | null

      An absolute API resource URL for this global configuration.

    • links object(uri-map) | null

      Contains absolute API resource URLs to access the webhook and default service configurations.
POST /v1/Configuration 
curl \
 --request POST 'https://conversations.twilio.com/v1/Configuration' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'DefaultClosedTimer=PT10M&DefaultInactiveTimer=PT1M&DefaultChatServiceSid=ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&DefaultMessagingServiceSid=MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
Request example 
{"DefaultClosedTimer"=>"PT10M", "DefaultInactiveTimer"=>"PT1M", "DefaultChatServiceSid"=>"ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "DefaultMessagingServiceSid"=>"MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}
Response examples (200) 
{
  "url": "https://conversations.twilio.com/v1/Configuration",
  "links": {
    "service": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration",
    "webhooks": "https://conversations.twilio.com/v1/Configuration/Webhooks"
  },
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "default_closed_timer": "PT10M",
  "default_inactive_timer": "PT1M",
  "default_chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "default_messaging_service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}