Skip to main content
PATCH
Update a SIP trunk

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.

Headers

Kallabot-Version
enum<string>

The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

trunk_id
string
required

Body

application/json
name
string | null
Required string length: 1 - 80
kind
string | null
Pattern: ^(carrier|pbx)$
preset
string | null
Maximum string length: 40
host
string | null
Maximum string length: 255
port
integer | null
Required range: 1 <= x <= 65535
transport
string | null
Pattern: ^(udp|tcp)$
auth_mode
string | null
Pattern: ^(ip|digest|register)$
username
string | null
Maximum string length: 120
password
string | null
Maximum string length: 200
from_domain
string | null
Maximum string length: 255
dial_format
string | null
Pattern: ^(e164|digits)$
dial_prefix
string | null
Pattern: ^[0-9#*]{0,10}$
headers
Header · object[] | null
Maximum array length: 10
inbound_ips
string[] | null
Maximum array length: 64
codecs
string[] | null
Maximum array length: 6
dtmf_mode
string | null
Pattern: ^(rfc4733|inband|info|auto)$
media_encryption
string | null
Pattern: ^(off|sdes)$

Response

Successful Response

id
string
required

The connection id.

name
string
required

Its name.

kind
string
required

carrier or pbx.

endpoint_name
string
required

Its name on our SIP edge.

headers
SipHeader · object[]
required

Extra X- headers we send.

inbound_ips
string[]
required

Where your calls come from.

codecs
string[]
required

Audio codecs, in order.

created_at
string
required

ISO 8601.

managed
boolean
required

Kallabot looks after it for numbers bought here; it can't be edited.

numbers
SipTrunkNumber · object[]
required

Its numbers.

preset
string | null

The carrier preset used.

host
string | null

Where we send calls.

port
integer | null

Its SIP port.

transport
string | null

udp or tcp.

auth_mode
string | null

ip, digest or register.

username
string | null

The SIP username.

secret_hint
string | null

The last characters of the password.

from_domain
string | null

The From domain we send.

dial_format
string | null

e164 or digits.

dial_prefix
string | null

Digits put before every dialled number.

dtmf_mode
string | null

How keypresses are sent.

media_encryption
string | null

off or sdes.

status
string | null

The last check's result.

status_detail
string | null

The check in plain words.

checked_at
string | null

When it was last checked.