This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

usergroup.massadd

Description

object usergroup.massadd(object parameters)

This method allows to simultaneously add permissions and users to multiple user groups.

This method is deprecated and will be removed in the future. Please use usergroup.update instead.

Parameters

(object) Parameters containing the IDs of the user groups to update and the permissions and users to add.

The method accepts the following parameters.

Parameter Type Description
usrgrpids
(required)
string/array IDs of user groups to update.
rights object/array Permissions to assign to the user groups.
userids string/array IDs of the users to add to the user groups.

Return values

(object) Returns an object containing the IDs of the updated user groups under the usrgrpids property.

Examples

Denying access to host group

Deny two user groups access to host group "2".

Request:

{
           "jsonrpc": "2.0",
           "method": "usergroup.massadd",
           "params": {
               "usrgrpids": [
                   "17",
                   "19"
               ],
               "rights": {
                   "permission": 0,
                   "id": "2"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "usrgrpids": [
                   "17",
                   "19"
               ]
           },
           "id": 1
       }

See also

Source

CUserGroup::massAdd() in frontends/php/include/classes/api/services/CUserGroup.php.