Skip to content

Update group employees

Updating groups of employees

Method update.group_employees
Description ::Deleting employee group::
Who has access Agent, Customer

You can update partially. If a bulk of data is updated, it replaces an existing one.

Parameters of a request

Title Type Required Valid value Descriprion
access_token string yes Authentication session key
id number yes Group ID
user_id number no Unique user ID of a customer or an agent who makes request.
Is mandatory for an agent
To get a list of customer users use the method "get.customer_users"
name string yes Group name
List of employees in a group
members array no List of unique IDs of employees, that belong to a group
Group extension number settings
group_phone_number string no Maximum length is 5 Group extension number
Depends on the component "va"
queue_enabled boolean no Default value is "false". In case all the numbers, attributed to a group, are busy, a caller can get in line for a redial to phone numbers in a list. Than, he or she will wait for the first number to become available.
Depends on the component "va"
channels_count number no From 1 to 199 Default value is 1.
Number of simultaneous channels when dialing
Depends on the component "va"

JSON request structure

{
  "jsonrpc":"2.0",
  "id":"number",
  "method":"update.group_employees",
  "params":{
    "access_token":"string",
    "id":"number",
    "user_id":"number",
    "name":"string",
    "members":[
      "employee_id"
    ],
    "group_phone_number":"string",
    "queue_enabled":"boolean",
    "channels_count":"number"
  }
}

JSON reply structure

{
  "jsonrpc":"2.0",
  "id":"number",
  "result":{

  }
}

List of returning errors

Refer to "List of errors for methods with the verb update"