Update an inbound SIP trunk

PATCH

https://api.smallest.ai/atoms/v1/sip-trunk/inbound/:trunkId

PATCH

/atoms/v1/sip-trunk/inbound/:trunkId

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/sip-trunk/inbound/trunkId"
4 
5 payload = {}
6 headers = {
7     "Authorization": "Bearer <token>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.patch(url, json=payload, headers=headers)
12 
13 print(response.json())

1 {
2   "status": true,
3   "data": {
4     "_id": "string",
5     "livekitTrunkId": "string",
6     "name": "string",
7     "numbers": [
8       "string"
9     ],
10     "allowedAddresses": [
11       "string"
12     ],
13     "allowedNumbers": [
14       "string"
15     ],
16     "mediaEncryption": "disable",
17     "krispEnabled": true,
18     "ringingTimeoutSeconds": 1,
19     "authUsername": "string",
20     "sipHost": "5rdbhjuwtlk.sip.livekit.cloud",
21     "agent": {
22       "id": "string",
23       "name": "string"
24     },
25     "isActive": true,
26     "createdAt": "2024-01-15T09:30:00Z",
27     "updatedAt": "2024-01-15T09:30:00Z"
28   }
29 }

Partial update; same fields and rules as create. Requires an admin-role key. The merged result must still carry at least one phone number or allowed caller number; peer addresses alone do not satisfy it (400 “A dedicated trunk needs at least one phone number…”). An empty body returns 400 (“Nothing to update”).

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

trunkIdstringRequired

Request

All fields optional; only the fields present are updated.

namestringOptional<=120 characters

numberslist of stringsOptional

Replaces the number list. E.164 with leading +.

allowedAddresseslist of stringsOptional

allowedNumberslist of stringsOptional

mediaEncryptionenumOptional

Allowed values:

krispEnabledbooleanOptional

ringingTimeoutSecondsintegerOptional1-600

authUsernamestringOptional

authPasswordstringOptional

Response

Updated trunk

statusbooleanOptional

dataobjectOptional

Errors

404

Not Found Error

409

Conflict Error