Trunk

Update a trunk.

Changed on

Updates the details of an existing trunk and returns the updated trunk's information.

put/trunks/{id}

Request

  • Base URL
    https://api.voipbin.net/v1.0
  • URL
    https://api.voipbin.net/v1.0/trunks/{id}
  • Auth
    none declared

Path parameters

idstring required

Request body

namestring

Omit to leave the current name unchanged.

detailstring

Omit to leave the current detail unchanged.

auth_typesRegistrarManagerAuthType[]

Omit to leave the current auth_types unchanged. NOTE: an explicit empty array is a valid value meaning no auth types, distinct from omitting the field.

usernamestring

Omit to leave the current username unchanged.

passwordstring

SIP trunk password. Omit to leave the current password unchanged. Sending an explicit value (including empty string) replaces it.

allowed_ipsstring[]

IP allowlist for this trunk. Omit to leave the current allowed_ips unchanged. NOTE: an explicit empty array clears the allowlist, distinct from omitting the field -- verify this is the intended effect before sending an empty array.

Example request

{
  "auth_types": [
    "basic"
  ]
}

Response

The updated trunk details.

idstring uuid

The unique identifier of the trunk. Returned from the POST /trunks or GET /trunks response.

customer_idstring uuid

The unique identifier of the customer who owns this trunk. Returned from the GET /customers response.

namestring

Display name of the trunk.

detailstring

Detailed description of the trunk.

domain_namestring

The SIP domain for this trunk.

auth_typesRegistrarManagerAuthType[]

List of authentication methods for this trunk.

usernamestring

The SIP username for authentication.

passwordstring

The SIP password for authentication.

allowed_ipsstring[]

List of IP addresses allowed for IP-based authentication.

tm_createstring date-time

The creation timestamp.

tm_updatestring date-time

The last update timestamp.

tm_deletestring date-time

The deletion timestamp.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "name": "Primary SIP Trunk",
  "detail": "Main SIP trunk for outbound calls",
  "domain_name": "sip.example.com",
  "auth_types": [
    "basic"
  ],
  "username": "trunk_user",
  "password": "s3cur3P@ss",
  "allowed_ips": [
    "203.0.113.10",
    "203.0.113.11"
  ],
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-16T14:20:00.000000Z",
  "tm_delete": "2026-01-17T18:45:00.000000Z"
}

Changes

  • 6c576a428361Revision changes
    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property became optional