User of the Internal Numbers Group (/user/extension_group/)

You can test API methods on the interactive API browser page and without writing code
Some of the resources described on the page may not be available by default due to the type of application (see Creating and authorizing applications).

This resource is intended for creating, deleting, and managing and refining user parameters at the internal numbers group level. The user of the internal number group level has access to the settings and resources of a specific internal numbers group, and depending on the access type, has full access or read-only access (read_only) without the right to make any changes in the settings.

Description of data structures

Name

Type

Mandatory

Description

Name

Type

Mandatory

Description

comment

string

none

Comment (note)

status

string

none

User status. Can be: 'active' or 'blocked'

name

string

yes

User Name

extension_group_id

integer

yes

ID of the internal numbers group for which the user is being created

access

string

none

The type of access to resources. Can be 'full' or 'read_only' (no rights for changes)

extra_params

string

none

Field for additional parameters, can be adapted for any purpose

timezone

string

none

User's time zone

login

string

yes

User Login

password

string

yes

User Password

email

string

yes

user's e-mail address

email_notify 

boolean

none

If the parameter takes the value 'True’, then the data for access to the system for the new user will be sent to the email address:

  • if the email_for_notify parameter is set – send it to the email from email_for_notify;

  • if the email_for_notify parameter is not set – to the current user (who creates)

email_for_notify

string

none

The field required for the email_notify parameter is the e-mail address where the data will be sent when creating a new user

Resources of the "Client" section

POST /client/{client_id}/extension_group/

Add a group of internal numbers

URL Parameters

Name

Type

Name

Type

client_id

string

JSON parameters

Name

Type

Mandatory

Name

Type

Mandatory

name

string

none

extra_params 

string

none

Response fields

Name

Type

Name

Type

id

integer

client_id

integer

name

string

extra_params 

string

GET /client/{client_id}/extension_group/

Get a list of the client's internal numbers groups

URL Parameters

Name

Type

Name

Type

client_id

string

Request parameters

Name

Type

Name

Type

id

array [string]

name

array [string]

Response fields

Name

Type

Name

Type

id

integer

client_id

integer

name

string

extra_params 

string

PUT /client/{client_id}/extension_group/{ext_group_id}

Add a group of internal numbers

URL Parameters

Name

Type

Name

Type

ext_group_id

integer

client_id

string

JSON parameters

Name

Type

Mandatory

Name

Type

Mandatory

name

string

none

extra_params 

string

none

Response fields

Name

Type

Name

Type

id

integer

client_id

integer

name

string

extra_params 

string

GET /client/{client_id}/extension_group/{ext_group_id}

Get a group of internal numbers

URL Parameters

Name

Type

Name

Type

ext_group_id

integer

client_id

string

Response fields

Name

Type

Name

Type

id

integer

client_id

integer

name

string

extra_params 

string

DELETE /client/{client_id}/extension_group/{ext_group_id}

Delete a group of internal numbers

URL Parameters

Name

Type

Name

Type

ext_group_id

integer

client_id

string