Sign in

v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB
Extension

Update an extension

Updates an existing extension and returns the updated details.

put/extensions/{id}

Path parameters

idstring required

The ID of the extension.

Request body

namestring required
detailstring required
passwordstring required

Response

The updated extension.

idstring uuid

The unique identifier of the extension. Returned from the POST /extensions or GET /extensions response.

customer_idstring uuid

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

namestring

Display name of the extension.

detailstring

Detailed description of the extension.

extensionstring

The SIP extension number.

domain_namestring

Domain name, same as the customer_id, used by Kamailio's INVITE validation

usernamestring

Username, same as the Extension, used by Kamailio's INVITE validation

passwordstring

The SIP password for authentication.

direct_hashstring

Hash for direct access via SIP URI sip:direct.<hash>@sip.voipbin.net. Returned from the resource's direct_hash field.

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": "Reception Desk",
  "detail": "Main reception extension for building A",
  "extension": "1001",
  "domain_name": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "username": "1001",
  "password": "s3cur3P@ss",
  "direct_hash": "a8f3b2c1d4e5",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-16T14:20:00.000000Z",
  "tm_delete": "2026-01-17T18:45:00.000000Z"
}