Connect or update the workspace's SIP trunk

Server URLloading...

PUT

/v1/sip-trunk

Send

Authorization

Body

Upserts the workspace's single trunk — there is no trunk ID in the path because a workspace has only ever had, at most, one. Refused with workspace.locked_to_platform_numbers on a workspace that already buys numbers from Sautikit.

For a registration trunk, the password is pushed to Sautikit's box and a REGISTER is attempted synchronously, inside this same request (up to ~20s). The response's status reflects the outcome immediately: active on success, failed (with last_error) if the provider rejected the credentials or was unreachable — the workspace stays unlocked either way until it actually succeeds. Omit password on a later PUT to keep the password already on file (e.g. when only changing a label); a password rotation re-signals every active BYO number on the trunk automatically.

For an ip_allowlist (signaling) trunk, this only submits the trunk for review — it lands at pending_approval and does not go live, or lock the workspace, until a person on Sautikit's operations team approves it and installs both the signalling and media IPs on the box.

Response Body

curl -X PUT "https://example.com/v1/sip-trunk" \  -H "Content-Type: application/json" \  -d '{    "label": "Head office trunk",    "auth_mode": "registration",    "proxy": "sip.example-carrier.com",    "transport": "udp",    "username": "sautikit_100",    "password": "…"  }'

{  "auth_mode": "registration",  "label": "string",  "realm": "string",  "proxy": "string",  "transport": "udp",  "username": "string",  "auth_username": "string",  "has_password": true,  "signaling_ips": [    "string"  ],  "media_ips": [    "string"  ],  "country_code": "string",  "outbound_number_format": "string",  "outbound_codec_prefs": "string",  "outbound_media_security": "string",  "status": "pending",  "last_error": "string"}

{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ]  }}

{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ]  }}