This API allows you to update the configuration of an existing trunk. You can modify the name, description, and rate limits. Only include fields you want to update; other fields will remain unchanged.
Note: The trunk_id andaccount_id cannot be changed after creation.
HTTP Request
PUT
https://api.vobiz.ai/api/v1/account/{account_id}/trunks/{trunk_id}Authentication: Bearer token required. Include X-Auth-ID header.
Request Parameters
All parameters are optional. Only include fields you want to update.
Request Parameters
| Name | Type | Description |
|---|---|---|
name | string | Update the trunk name. Maximum 255 characters. |
description | string | Update the trunk description. |
enabled | boolean | Enable or disable the trunk. Set to false to temporarily disable without deleting. |
Response
Returns the complete updated trunk object with the new updated_at timestamp.
Response - 200 OK
{
"trunk_id": "aabbcc-dd-ee-ff-gg",
"account_id": "MA_XYZ123",
"name": "Updated Production Trunk",
"trunk_domain": "aabbcc.sip.vobiz.ai",
"trunk_status": "active",
"secure": false,
"trunk_direction": "both",
"username": "testuser",
"password": "TestPassword123!",
"concurrent_calls_limit": 10,
"cps_limit": 2,
"ip_whitelist": [
"198.51.100.10",
"10.0.0.0/8"
],
"credential_uuid": "xyz-abc-123",
"description": "Updated description for production trunk",
"transport": "udp",
"created_at": "2025-11-03T14:09:12.08032875Z",
"updated_at": "2025-11-03T14:10:15.12345678Z"
}Examples
cURL - Update Name Only
cURL Request
curl -X PUT https://api.vobiz.ai/api/v1/account/{Auth_ID}/trunks/bfab10fb-cb97-488b-9c63-989c32980b0f \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Updated Production Trunk"
}'cURL - Disable Trunk
cURL Request
curl -X PUT https://api.vobiz.ai/api/v1/account/{Auth_ID}/trunks/bfab10fb-cb97-488b-9c63-989c32980b0f \
-H "X-Auth-ID: YOUR_AUTH_ID" \
-H "X-Auth-Token: YOUR_AUTH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"enabled": false
}'Best Practice: Disable a trunk instead of deleting it if you might need the configuration later. Disabled trunks won't handle calls but preserve all settings, credentials, and routing rules.