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 screenitem.updatebyposition(array screenItems)

This method allows to update screen items in the given screen cells. If a cell is empty, a new screen item will be created.


(array) Screen item properties to be updated.

The x, y and screenid properties must be defined for each screen item, 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 and created screen items under the screenitemids property.


Changing a screen items resource ID

Change the resource ID for the screen element located in the upper-left cell of the screen.


           "jsonrpc": "2.0",
           "method": "screenitem.updatebyposition",
           "params": [
                   "screenid": "16",
                   "x": 0,
                   "y": 0,
                   "resourceid": "644"
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1


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

See also


CScreenItem::update() in frontends/php/include/classes/api/services/CScreenItem.php.