Edit an Extension

Edit an extension.

Request URL

POST {base_url}/{api_path}/extension/update?access_token={access_token}

Request parameters

Parameter Required Type Description
id Yes Integer The unique ID of an extension.
Note: You can query extension's ID using Search Specific Extensions.
first_name No String First name.
last_name No String Last name.
email_addr No String Email address.
mobile_number No String Mobile number.
user_password No String User password.
Note:
  • Must contain numbers, uppercase, and lowercase letters.
  • The minimum character length is 10 and the maximum is 63.
role_id No Integer The ID of a user role.
Note: You can query user role's ID using Get Menu Options.
organization_list No Array <Organization_Info> The organization(s) to which the extension belongs.
Note: This parameter is required if the Organization Management feature is enabled.
title No String The job title of the extension user.
caller_id No String Caller ID.
Note:
  • Numbers, letters, and special characters ( ) . - + * # are allowed.
  • The maximum character length is 31.
reg_name No String Registration name.
Note: The maximum character length is 63.
reg_password No String Registration password.
Note: The minimum character length is 8 and the maximum is 63.
concurrent_registrations No Integer IP phone concurrent registration.

Valid value:

  • 1 (default)
  • 2
  • 3
presence_status No String The extension presence status.

Valid value:

  • available: Available
  • away: Away
  • business_trip: Business Trip
  • do_not_disturb: Do Not Disturb (DND)
  • lunch: Lunch Break
  • off_work: Off Work
presence_list No Array <Presence_Setting> The list of the presence settings.
presence_mobile_prefix No String The dial-out prefix of the mobile number for the "Ring the Mobile Number Simultaneously" feature.
agent_id No String

The agent ID that will be announced in the greeting prompt to callers when their inbound calls are answered by queue agent.

By default, the extension number will be announced.

Note: Agent ID will be announced when Agent ID Announcement is enabled for queues on PBX web portal (Path: Call Features > Queue > Preferences > Announcement).
enb_vm No Integer Whether to enable the voicemail.

Valid value:

  • 0: Disable
  • 1: Enable
enb_vm_pin No Integer Whether to enable the voicemail PIN authentication.

Valid value:

  • 0: Disable
  • 1: Enable
vm_pin No String The PIN code to access voicemail.
vm_lang No String The system prompt language used by the extension's voicemail.

Valid value:

Note: Make sure that the desired language exists in the PBX (Path: PBX Settings > Voice Prompt > System Prompt).
  • follow_system: Use the default system prompt language.
  • sound-ar: العربية (Arabic)
  • sound-cz: Čeština(Czech)
  • sound-de: Deutsch (German)
  • sound-en: English
  • sound-en_BR: English (British)
  • sound-es: Español/Castellano (Spanish Spain)
  • sound-es_LT: Español latino (Spanish Latin)
  • sound-fa: فارسی (Persian)
  • sound-fr: Française (French)
  • sound-gr: Ελληνικά (Greek)
  • sound-hr: hrvatski (Croatian)
  • sound-id: Bahasa Indonesia (Indonesian)
  • sound-it: Italiano (Italian)
  • sound-iw: עברית (Hebrew)
  • sound-nl: Nederlands (Dutch)
  • sound-pl: Polski (Polish)
  • sound-pt: Português (Portuguese)
  • sound-pt_BR: Português Brasil (Portuguese Brazil)
  • sound-ro: Română (Romanian)
  • sound-ru: Pусский (Russian)
  • sound-sk: Slovenčina(Slovak)
  • sound-sl: Slovenščina (Slovenian)
  • sound-sr: Cрпски (Serbian)
  • sound-th: ไทย (Thai)
  • sound-tr: Türk (Turkish)
  • sound-zh: 中文 (Chinese)
  • sound-zh_hk: 粤语 (Cantonese)
new_vm_notification No String Whether to notify the extension when receiving a new voicemail message, and how to notify.

Valid value:

  • no: Do not send email notifications.
  • with_attach: Send a notification email with the new voicemail message attached as a .wav file.
  • without_attach: Send a notification email without attaching the new voicemail message.
vm_after_notification No String How to deal with the voicemail message after sending an email to notify the extension.

Valid value:

  • no: Keep the voicemail message in mailbox as unread.
  • mark_read: Keep the voicemail message in mailbox as read.
  • delete: Delete the voicemail message.
    Note: This value is supported only when new_vm_notification is set to with_attach.
enb_all_reject_mode_for_endpoints No Integer Whether to stop ringing other endpoints when an incoming call is rejected on one of the endpoints (with the extension registered).

Valid value:

  • 0: Disable. When an incoming call is rejected on one endpoint, other endpoints still ring.
  • 1: Enable. When an incoming call is rejected on one endpoint, other endpoints stop ringing.
dtmf_mode No String DTMF mode.

Valid value:

  • rfc4733: RFC4733 (RFC2833)
  • info: Info
  • inband: Inband
  • auto: Auto
transport No String Transport protocol.

Valid value:

  • udp: UDP protocol
  • tcp: TCP protocol
  • tls: TLS protocol
enb_qualify No Integer Whether to enable Qualify.

Valid value:

  • 0: Disable
  • 1: Enable
enb_t38_support No Integer Whether to support T.38 fax.

Valid value:

  • 0: Disable
  • 1: Enable
enb_nat No Integer Whether to enable NAT.

Valid value:

  • 0: Disable
  • 1: Enable
enb_srtp No Integer Whether to enable SRTP.

Valid value:

  • 0: Disable
  • 1: Enable
allow_reg_remotely No Integer Whether to enable remote registration.

Valid value:

  • 0: Disable
  • 1: Enable
disable_outb_call No Integer Whether to restrict the extension from making outbound calls.

Valid value:

  • 0: Allow to make outbound calls.
  • 1: NOT allowed to make outbound calls.
disable_outb_call_outside_business_hours No Integer Whether to restrict the extension from making outbound calls outside Business Hours.

Valid value:

  • 0: Allow to make outbound calls outside Business Hours.
  • 1: NOT allowed to make outbound calls outside Business Hours.
disable_international_call No Integer Whether to restrict the extension from making international calls.

Valid value:

  • 0: Allow to make international calls.
  • 1: NOT allowed to make international calls.
outbound_route_permission No Array <Integer> The unique ID(s) of outbound route(s) that the extension is allowed to use.
Note:
enb_mobile_client No Integer Whether to enable Linkus Mobile Client.

Valid value:

  • 0: Disable
  • 1: Enable
enb_desktop_client No Integer Whether to enable Linkus Desktop Client.

Valid value:

  • 0: Disable
  • 1: Enable
enb_web_client No Integer Whether to enable Linkus Web Client.

Valid value:

  • 0: Disable
  • 1: Enable
enb_pad_client No Integer Whether to enable Linkus Pad Client (SDK).

Valid value:

  • 0: Disable
  • 1: Enable
Note: This option takes effect ONLY when you have integrated the Linkus SDK for Android or Linkus SDK for iOS.
linkus_mobile_codec No String Set codec for Linkus Mobile Client.

Valid value:

  • ulaw
  • alaw
  • ilbc
  • g722
  • g729
enb_ice No String

Whether to enable ICE (Interactive Connectivity Establishment) for Linkus Mobile Client.

Valid value:

  • yes: Enable ICE.
  • no: Disable ICE.
client_conf_list No Array <Linkus_Clients_Setting> The list of the Linkus Clients settings.
Organization_Info
Parameter Required Type Description
value Yes String The unique ID of an organization.
Note: You can query organization's ID using Get Menu Options.
Presense_Setting
Parameter Required Type Description
status Yes String Extension presence.

Valid value:

  • available: Available
  • away: Away
  • business_trip: Business Trip
  • do_not_disturb: Do Not Disturb (DND)
  • lunch: Lunch Break
  • off_work: Off Work
enb_in_always_forward No Integer Whether to always forward internal incoming calls to a specific destination (Always condition).

Valid value:

  • 0: Disable
  • 1: Enable
in_always_forward_dest No String The destination type for internal call forwarding in Always condition.

Valid value:

  • extension: Extension
  • ext_vm: Extension Voicemail
  • ivr: IVR
  • ring_group: Ring Group
  • queue: Queue
  • group_vm: Group Voicemail
  • mobile_number: Mobile Number
  • external_num: External Number
  • play_greeting: Play Greeting then Hang up
  • end_call: Hang Up
Note: When the destination type is ext_vm or mobile_number, the system will automatically retrieve the corresponding destination value from the extension information.
in_always_forward_prefix No String The parameter defines different settings depending on the destination type for internal call forwarding in Always condition.
  • When the destination type is mobile_number or external_num, the parameter defines the dial-out prefix of the external destination number.
  • When the destination type is play_greeting, the parameter defines the play count of the greeting. The valid value is 1 - 5.
in_always_forward_value No String The destination for internal call forwarding in Always condition.

This parameter is REQUIRED for the following destination types:

  • When the destination type is play_greeting, this parameter defines the custom prompt file name. E.g. demo.wav.
  • When the destination type is extension, ivr, ring_group, queue, or group_vm, this parameter should be the unique ID of the destination.
    For example, the destination is the extension 2002, then this parameter should be set to the extension's ID 2.
    Note:
in_always_forward_num No String The external number of the external_num destination for internal call forwarding in Always condition.
enb_in_no_answer_forward No Integer Whether to forward internal calls to a specific destination when the calls are not answered (No Answer condition).

Valid value:

  • 0: Disable
  • 1: Enable
in_no_answer_forward_dest No String The destination type for internal call forwarding in No Answer condition.

Valid value:

  • extension: Extension
  • ext_vm: Extension Voicemail
  • ivr: IVR
  • ring_group: Ring Group
  • queue: Queue
  • group_vm: Group Voicemail
  • mobile_number: Mobile Number
  • external_num: External Number
  • play_greeting: Play Greeting then Hang up
  • end_call: Hang Up
Note: When the destination type is ext_vm or mobile_number, the system will automatically retrieve the corresponding destination value from the extension information.
in_no_answer_forward_prefix No String The parameter defines different settings depending on the destination type for internal call forwarding in No Answer condition.
  • When the destination type is mobile_number or external_num, the parameter defines the dial-out prefix of the external destination number.
  • When the destination type is play_greeting, the parameter defines the play count of the greeting. The valid value is 1 - 5.
in_no_answer_forward_value No String The destination for internal call forwarding in No Answer condition.

This parameter is REQUIRED for the following destination types:

  • When the destination type is play_greeting, this parameter defines the custom prompt file name. E.g. demo.wav.
  • When the destination type is extension, ivr, ring_group, queue, or group_vm, this parameter should be the unique ID of the destination.
    For example, the destination is the extension 2002, then this parameter should be set to the extension's ID 2.
    Note:
in_no_answer_forward_num No String The external number of the external_num destination for internal call forwarding in No Answer condition.
enb_in_busy_forward No Integer Whether to forward internal calls to a specific destination when the extension is busy (Busy condition).

Valid value:

  • 0: Disable
  • 1: Enable
in_busy_forward_dest No String The destination type for internal call forwarding in Busy condition.

Valid value:

  • extension: Extension
  • ext_vm: Extension Voicemail
  • ivr: IVR
  • ring_group: Ring Group
  • queue: Queue
  • group_vm: Group Voicemail
  • mobile_number: Mobile Number
  • external_num: External Number
  • play_greeting: Play Greeting then Hang up
  • end_call: Hang Up
Note: When the destination type is ext_vm or mobile_number, the system will automatically retrieve the corresponding destination value from the extension information.
in_busy_forward_prefix No String The parameter defines different settings depending on the destination type for internal call forwarding in Busy condition.
  • When the destination type is mobile_number or external_num, the parameter defines the dial-out prefix of the external destination number.
  • When the destination type is play_greeting, the parameter defines the play count of the greeting. The valid value is 1 - 5.
in_busy_forward_value No String The destination for internal call forwarding in Busy condition.

This parameter is REQUIRED for the following destination types:

  • When the destination type is play_greeting, this parameter defines the custom prompt file name. E.g. demo.wav.
  • When the destination type is extension, ivr, ring_group, queue, or group_vm, this parameter should be the unique ID of the destination.
    For example, the destination is the extension 2002, then this parameter should be set to the extension's ID 2.
    Note:
in_busy_forward_num No String The external number of the external_num destination for internal call forwarding in Busy condition.
enb_ex_always_forward No Integer Whether to always forward external calls to a specific destination (Always condition).

Valid value:

  • 0: Disable
  • 1: Enable
ex_always_forward_dest No String The destination type for external call forwarding in Always condition.

Valid value:

  • extension: Extension
  • ext_vm: Extension Voicemail
  • ivr: IVR
  • ring_group: Ring Group
  • queue: Queue
  • group_vm: Group Voicemail
  • mobile_number: Mobile Number
  • external_num: External Number
  • play_greeting: Play Greeting then Hang up
  • end_call: Hang Up
Note: When the destination type is ext_vm or mobile_number, the system will automatically retrieve the corresponding destination value from the extension information.
ex_always_forward_prefix No String The parameter defines different settings depending on the destination type for external call forwarding in Always condition.
  • When the destination type is mobile_number or external_num, the parameter defines the dial-out prefix of the external destination number.
  • When the destination type is play_greeting, the parameter defines the play count of the greeting. The valid value is 1 - 5.
ex_always_forward_value No String The destination for external call forwarding in Always condition.

This parameter is REQUIRED for the following destination types:

  • When the destination type is play_greeting, this parameter defines the custom prompt file name. E.g. demo.wav.
  • When the destination type is extension, ivr, ring_group, queue, or group_vm, this parameter should be the unique ID of the destination.
    For example, the destination is the extension 2002, then this parameter should be set to the extension's ID 2.
    Note:
ex_always_forward_num No String The external number of the external_num destination for external call forwarding in Always condition.
enb_ex_no_answer_forward No Integer Whether to forward external calls to a specific destination when the calls are not answered (No Answer condition).

Valid value:

  • 0: Disable
  • 1: Enable
ex_no_answer_forward_dest No String The destination type for external call forwarding in No Answer condition.

Valid value:

  • extension: Extension
  • ext_vm: Extension Voicemail
  • ivr: IVR
  • ring_group: Ring Group
  • queue: Queue
  • group_vm: Group Voicemail
  • mobile_number: Mobile Number
  • external_num: External Number
  • play_greeting: Play Greeting then Hang up
  • end_call: Hang Up
Note: When the destination type is ext_vm or mobile_number, the system will automatically retrieve the corresponding destination value from the extension information.
ex_no_answer_forward_prefix No String The parameter defines different settings depending on the destination type for external call forwarding in No Answer condition.
  • When the destination type is mobile_number or external_num, the parameter defines the dial-out prefix of the external destination number.
  • When the destination type is play_greeting, the parameter defines the play count of the greeting. The valid value is 1 - 5.
ex_no_answer_forward_value No String The destination for external call forwarding in No Answer condition.

This parameter is REQUIRED for the following destination types:

  • When the destination type is play_greeting, this parameter defines the custom prompt file name. E.g. demo.wav.
  • When the destination type is extension, ivr, ring_group, queue, or group_vm, this parameter should be the unique ID of the destination.
    For example, the destination is the extension 2002, then this parameter should be set to the extension's ID 2.
    Note:
ex_no_answer_forward_num No String The external number of the external_num destination for external call forwarding in No Answer condition.
enb_ex_busy_forward No Integer Whether to forward external calls to a specific destination when the extension is busy (Busy condition).

Valid value:

  • 0: Disable
  • 1: Enable
ex_busy_forward_dest No String The destination type for external call forwarding in Busy condition.

Valid value:

  • extension: Extension
  • ext_vm: Extension Voicemail
  • ivr: IVR
  • ring_group: Ring Group
  • queue: Queue
  • group_vm: Group Voicemail
  • mobile_number: Mobile Number
  • external_num: External Number
  • play_greeting: Play Greeting then Hang up
  • end_call: Hang Up
Note: When the destination type is ext_vm or mobile_number, the system will automatically retrieve the corresponding destination value from the extension information.
ex_busy_forward_prefix No String The parameter defines different settings depending on the destination type for external call forwarding in Busy condition.
  • When the destination type is mobile_number or external_num, the parameter defines the dial-out prefix of the external destination number.
  • When the destination type is play_greeting, the parameter defines the play count of the greeting. The valid value is 1 - 5.
ex_busy_forward_value No String The destination for external call forwarding in Busy condition.

This parameter is REQUIRED for the following destination types:

  • When the destination type is play_greeting, this parameter defines the custom prompt file name. E.g. demo.wav.
  • When the destination type is extension, ivr, ring_group, queue, or group_vm, this parameter should be the unique ID of the destination.
    For example, the destination is the extension 2002, then this parameter should be set to the extension's ID 2.
    Note:
ex_busy_forward_num No String The external number of the external_num destination for external call forwarding in Busy condition.
ring_timeout No Integer The ringing timeout for incoming calls (Unit: Second).
enb_ring_mobile No Integer Whether the mobile phone will ring simultaneously when the extension rings.

Valid value:

  • 0: Disable
  • 1: Enable
Linkus_Clients_Setting
Parameter Required Type Description
id Yes Integer Linkus Client ID.
Note: You can query extension's Linkus Client ID using Query Information of an Extension.
client Yes String The type of Linkus Client for which you want to configure features such as call waiting, auto-answer for paging/intercom calls, or auto-answer for non-paging/intercom calls.

Valid value:

  • linkusmobile: Linkus Mobile Client
  • linkusdesktop: Linkus Desktop Client
  • linkusweb: Linkus Web Client
enb_call_waiting No Integer Whether to allow the extension to receive another call while already on the phone.

Valid value:

  • 0: Disabled
  • 1: Enabled
enb_auto_answer No Integer

Whether to automatically answer non-paging/intercom calls.

Valid value:

  • 0: Disabled
  • 1: Enabled
auto_answer_delay_time No Integer

The delay time before automatically answering non-paging/intercom calls (Unit: Second).

Valid value: 0 - 60
Note: 0 indicates that incoming non-paging/intercom calls will be auto-answered immediately.
enb_auto_answer_tone No Integer

Whether to alert the extension with a tone when a non-paging/intercom call is automatically answered.

Valid value:

  • 0: Disabled
  • 1: Enabled
enb_auto_answer_paging No Integer Whether to automatically answer paging/intercom calls.

Valid value:

  • 0: Disabled
  • 1: Enabled
enb_auto_answer_paging_barge No Integer Whether to automatically answer paging/intercom calls during an active call.

Valid value:

  • 0: Disabled
  • 1: Enabled
enb_auto_answer_paging_tone No Integer Whether to alert the extension with a tone when a paging/intercom call is automatically answered.

Valid value:

  • 0: Disabled
  • 1: Enabled

Response parameters

Parameter Type Description
errcode Integer Returned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note: You can check the error code and error message in Error Code and Error Message.
errmsg String Returned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.

Examples

Request example

Change the outbound route permission of extension 2000 (ID is "39").

POST /openapi/v1.0/extension/update?access_token=5SwyByhbSfsNlpI1v4GtHxEDmKsZwzjQ HTTP/1.1
Host: 192.168.5.150:8088
Content-Type: application/json
{
    "id":39,
    "outbound_route_permission":[69,70,73]
}

Response example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS"
}