Skip to content

telephony.configs.update

Change a carrier account.

The provider cannot be changed once a configuration exists — create a new configuration if you need to switch providers.

When rotating credentials, you only need to send the fields you’re changing. Re-submitting a masked sensitive value preserves the original secret, so it’s safe to round-trip a GET response back to a PUT.

Reference

PUT/api/v1/organizations/telephony-configs/{config_id}

Auth
API key in X-API-Key
Content
application/json
Returns
200 · TelephonyConfigurationDetail

Arguments

ArgumentInTypeRequiredDescription
config_idpathintegerrequired
namebodystringoptional
configbodyARIConfigurationRequest | CloudonixConfigurationRequest | PlivoConfigurationRequest | TelnyxConfigurationRequest | TwilioConfigurationRequest | VobizConfigurationRequest | VonageConfigurationRequestoptional

Example request

curl -X PUT "https://api.decibyl.ai/api/v1/organizations/telephony-configs/<config_id>" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","config":{"provider":"ari","ari_endpoint":"string","app_name":"string","app_password":"string","ws_client_name":"","from_numbers":["string"]}}'

Response

{
  "id": 1,
  "name": "string",
  "provider": "string",
  "is_default_outbound": true,
  "credentials": {},
  "created_at": "2026-09-14T09:30:00Z",
  "updated_at": "2026-09-14T09:30:00Z"
}

Errors

StatusWhen
404Not found
422Validation Error