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.



object usermacro.updateglobal(object/array globalMacros)

This method allows to update existing global macros.

This method is only available to Super admin user type. Permissions to call the method can be revoked in user role settings. See User roles for more information.


(object/array) Global macro properties to be updated.

The globalmacroid property must be defined for each global macro, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.

Return values

(object) Returns an object containing the IDs of the updated global macros under the globalmacroids property.


Changing the value of a global macro

Change the value of a global macro to "public".


           "jsonrpc": "2.0",
           "method": "usermacro.updateglobal",
           "params": {
               "globalmacroid": "1",
               "value": "public"
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1


           "jsonrpc": "2.0",
           "result": {
               "globalmacroids": [
           "id": 1


CUserMacro::updateGlobal() in ui/include/classes/api/services/CUserMacro.php.