Skip to main content
PUT
/
api
/
v1
/
channels
Python (SDK)
import os
from syllable_sdk import SyllableSDK, models


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.channels.update(request={
        "name": "twilio",
        "channel_service": models.ChannelServices.SIP,
        "supported_modes": "chat,voice",
        "is_system_channel": False,
        "config": {
            "account_sid": "AC123...",
            "auth_token": "sometoken",
            "provider_credentials": {
                "api_key": "atk123",
                "username": "test_username",
            },
            "telephony": {
                "pre_input_timeout": 1.2,
                "overall_input_timeout": 20,
                "interruptibility": "dtmf_only",
                "passive_speech_input_enabled": True,
                "passive_input_start": 0.5,
            },
            "email": {
                "sending_domain": "mail.example.com",
            },
        },
        "id": 1,
    })

    # Handle response
    print(res)
{
  "name": "<string>",
  "channel_service": "sip",
  "id": 123,
  "supported_modes": "chat,voice",
  "is_system_channel": true,
  "config": {
    "telephony": {
      "interruptibility": "dtmf_only",
      "overall_input_timeout": 20,
      "passive_input_start": 0.5,
      "passive_speech_input_enabled": true,
      "pre_input_timeout": 1.2
    }
  }
}

Authorizations

​
Syllable-API-Key
string
header
required

Body

application/json

Request model to update a channel through the organizations API

​
name
string
required

The channel name

Example:

"twilio"

​
channel_service
enum<string>
required

The service that facilitates communication on the channel

Available options:
sip,
twilio,
email,
webchat,
africastalking
Example:

"webchat"

​
config
OrganizationChannelConfig · object
required

The configuration of the channel

Examples:
{
  "account_sid": "AC123",
  "auth_token": "sometoken",
  "telephony": {
    "interruptibility": "dtmf_only",
    "passive_input_start": 0.5,
    "passive_speech_input_enabled": true,
    "pre_input_timeout": 3
  }
}
{
  "provider_credentials": {
    "api_key": "atk123",
    "username": "test_username"
  },
  "telephony": {
    "interruptibility": "dtmf_only",
    "passive_input_start": 0.5,
    "passive_speech_input_enabled": true,
    "pre_input_timeout": 3
  }
}
​
id
integer
required

The internal ID of the channel

Example:

1

​
supported_modes
string | null

The comma-delimited list of supported modes for the channel, which defines the possible communication methods for channel targets linked to it.

Example:

"chat,voice"

​
is_system_channel
boolean
default:true

Whether the channel is a built-in system channel (i.e., is not customizable)

Example:

false

Response

Successful Response

​
name
string
required

The channel name

Example:

"syllable-webchat"

​
channel_service
enum<string>
required

The service that facilitates communication on the channel

Available options:
sip,
twilio,
email,
webchat,
africastalking
Example:

"webchat"

​
id
integer
required

The channel ID

​
supported_modes
string | null

The comma-delimited list of supported modes for the channel, which defines the possible communication methods for channel targets linked to it.

Example:

"chat,voice"

​
is_system_channel
boolean
default:true

Whether the channel is a built-in system channel (i.e., is not customizable)

Example:

false

​
config
ChannelConfigView · object

Configuration for the channel

Example:
{
  "telephony": {
    "interruptibility": "dtmf_only",
    "overall_input_timeout": 20,
    "passive_input_start": 0.5,
    "passive_speech_input_enabled": true,
    "pre_input_timeout": 1.2
  }
}