API : PBX : Phonebook group delete

A phonebook group is a named group of phonebook contacts. Other features point at a group by its id, e.g. to route a call depending on whether the caller is in the group.

There are two kinds of groups:

• Customer groups hold the customers shared contacts. Every user of the customer can see them. Access level MANAGER or above is required to create, rename and delete them.
• Personal groups belong to one employee and hold that employees personal contacts. The employee manages them, and so does another employee who has the group right readPhonebook (to see them) or writePhonebook (to change them) on the employee.

A contact selects its groups through its groups property when it is created or updated. A shared contact can only be in customer groups, a personal contact only in the personal groups of its own employee.

This request deletes a group. The group is first taken out of every contact in it, so no contact keeps a reference to a group that no longer exists. The contacts themselves are not deleted.

A customer group that a value router routes calls on (rule type A_NUMBER_IN_PHONEBOOK_GROUP) cannot be deleted: the request fails with 409 and names the value routers. Remove those rules first.

{
  success: true,
  contacts: 12
}