Skip to main content
PUT
/
api
/
v1
/
account
/
{auth_id}
/
trunks
/
{trunk_id}
Update a trunk
curl --request PUT \
  --url https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/{trunk_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "name": "<string>",
  "max_concurrent_calls": 123,
  "enabled": true
}
'
{
  "trunk_id": "99887766-1234-5678-90ab-cdef12345678",
  "account_id": "MA_XXXXXXXX",
  "name": "Acme Production Trunk Updated",
  "trunk_domain": "99887766-1234-5678-90ab-cdef12345678.sip.vobiz.ai",
  "trunk_status": "active",
  "secure": false,
  "trunk_direction": "both",
  "concurrent_calls_limit": 10,
  "cps_limit": 2,
  "description": "",
  "transport": "udp",
  "recording": false,
  "enable_transcription": false,
  "pii_redaction": false,
  "webhook_method": "POST",
  "recording_webhook_enabled": false,
  "created_at": "2026-03-25T10:00:00Z",
  "updated_at": "2026-03-25T10:05:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

PUT https://api.vobiz.ai/api/v1/account/{auth_id}/trunks/{trunk_id}
Use this endpoint to update the configuration of an existing trunk. You can modify the name, description, and rate limits. Include only the fields you want to update; other fields will remain unchanged.
Authentication required:
  • X-Auth-ID - Your account Auth ID
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json
Note: trunk_id and auth_id cannot be changed after creation.

​
Request Parameters

All parameters are optional. Only include fields you want to update.
FieldTypeRequiredDescription
namestringNoUpdated name for the trunk. Maximum 255 characters.
descriptionstringNoUpdated description for the trunk.
enabledbooleanNoEnables or disables the trunk. Set to false to temporarily disable without deleting.

​
Examples

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

​
Response

Returns the complete trunk object with updated values and a new updated_at timestamp.
Response - 200 OK
{
  "trunk_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "account_id": "MA_XXXXXXXX",
  "name": "Acme Production Trunk",
  "trunk_domain": "aabbccdd-1234-5678-90ab-cdef12345678.sip.vobiz.ai",
  "trunk_status": "active",
  "secure": false,
  "trunk_direction": "both",
  "concurrent_calls_limit": 10,
  "cps_limit": 2,
  "description": "",
  "transport": "udp",
  "recording": false,
  "enable_transcription": false,
  "pii_redaction": false,
  "webhook_method": "POST",
  "recording_webhook_enabled": false,
  "created_at": "2026-05-12T05:11:52.054462Z",
  "updated_at": "2026-05-12T05:12:18.147340Z"
}
Best Practice: Disable a trunk instead of deleting it if you might need the configuration later. Disabled trunks do not handle calls but preserve all settings, credentials, and routing rules.

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

​
trunk_id
string
required

Body

application/json
​
name
string
required
​
max_concurrent_calls
integer
required
​
enabled
boolean
required

Response

200 - application/json

Trunk updated

​
trunk_id
string
required
​
account_id
string
required
​
name
string
required
​
trunk_domain
string
required
​
trunk_status
string
required
​
secure
boolean
required
​
trunk_direction
string
required
​
concurrent_calls_limit
integer
required
​
cps_limit
integer
required
​
description
string
required
​
transport
string
required
​
recording
boolean
required
​
enable_transcription
boolean
required
​
pii_redaction
boolean
required
​
webhook_method
string
required
​
recording_webhook_enabled
boolean
required
​
created_at
string
required
​
updated_at
string
required