Zum Hauptinhalt springen
PUT
/
api
/
user
/
phone-numbers
/
sip-trunks
/
{id}
SIP-Trunk aktualisieren
curl --request PUT \
  --url https://app.famulor.de/api/user/phone-numbers/sip-trunks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>",
  "sip_username": "<string>",
  "sip_password": "<string>",
  "sip_address": "<string>",
  "sip_calling_format": "<string>",
  "inbound_authorization_type": "<string>",
  "allowed_inbound_ips": [
    {}
  ],
  "country_code": "<string>",
  "outbound_proxy": true
}
'
{
  "message": "SIP trunk updated successfully.",
  "data": {
    "id": 42,
    "phone_number": "1000",
    "sip_username": "new_username",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_newtrunkid1",
    "outbound_trunk_id": "ST_newtrunkid2",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T12:00:00.000000Z"
  }
}
Dieser Endpunkt aktualisiert einen bestehenden SIP-Trunk. Senden Sie nur die Felder, die Sie aendern moechten - partielle Updates werden unterstuetzt. Aenderungen an Zugangsdaten, Adresse oder Proxy-Einstellungen fuehren automatisch zur erneuten Provisionierung der betroffenen Voice-Trunks.

​
Pfad-Parameter

​
id
integer
erforderlich
Die eindeutige Kennung des zu aktualisierenden SIP-Trunks

​
Body-Parameter

Alle Felder sind optional. Senden Sie nur die Felder, die Sie aendern moechten.
​
phone_number
string
Die SIP-Erweiterung oder Telefonnummer (1-15 Zeichen)
​
sip_username
string
Benutzername fuer SIP-Authentifizierung (3-128 Zeichen)
​
sip_password
string
Passwort fuer SIP-Authentifizierung (mindestens 3 Zeichen)
​
sip_address
string
SIP-Serveradresse ohne Port
​
sip_calling_format
string
Ausgehendes Rufnummernformat: +e164, e164 oder national
​
inbound_authorization_type
string
Authentifizierung fuer eingehende Anrufe: auth oder ip. Beim Wechsel auf ip muss allowed_inbound_ips mitgegeben werden. Beim Wechsel auf auth wird eine vorhandene IP-Whitelist entfernt.
​
allowed_inbound_ips
array
Array erlaubter IP-Adressen fuer eingehende Anrufe. Pflichtfeld, wenn inbound_authorization_type auf ip gesetzt wird.
​
country_code
string
ISO-3166-2-Landercode
​
outbound_proxy
boolean
Leitet ausgehende Anrufe ueber eine feste IP-Adresse

​
Antwort

​
message
string
Erfolgsmeldung
​
data
object
Das aktualisierte SIP-Trunk-Objekt (gleiche Felder wie bei SIP-Trunk abrufen)
{
  "message": "SIP trunk updated successfully.",
  "data": {
    "id": 42,
    "phone_number": "1000",
    "sip_username": "new_username",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_newtrunkid1",
    "outbound_trunk_id": "ST_newtrunkid2",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T12:00:00.000000Z"
  }
}

​
Re-Provisionierungsverhalten

Die folgenden Feld-Aenderungen loesen eine automatische Re-Provisionierung der Voice-Infrastruktur-Trunks aus:
Geaendertes FeldInbound-TrunkOutbound-Trunk
sip_usernameNeu erzeugtNeu erzeugt
sip_passwordNeu erzeugtNeu erzeugt
sip_address-Neu erzeugt
phone_numberNeu erzeugtNeu erzeugt
inbound_authorization_typeNeu erzeugt-
allowed_inbound_ipsNeu erzeugt-
outbound_proxy-Neu erzeugt
Felder wie sip_calling_format oder country_code werden nur lokal gespeichert und loesen keine Re-Provisionierung aus.