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 maintenance.create(object/array maintenances)

This method allows to create new maintenances.


(object/array) Maintenances to create.

Additionally to the standard maintenance properties, the method accepts the following parameters.

Parameter Type Description
array IDs of the host groups that will undergo maintenance.
array IDs of the hosts that will undergo maintenance.
array Maintenance time periods.
tags array Problem tags.

Define what problems must be suppressed.
If no tags are given, all active maintenance host problems will be suppressed.

At least one host or host group must be defined for each maintenance.

Return values

(object) Returns an object containing the IDs of the created maintenances under the maintenanceids property. The order of the returned IDs matches the order of the passed maintenances.


Creating a maintenance

Create a maintenance with data collection for host group "2" with problem tags service:mysqld and error. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour.


           "jsonrpc": "2.0",
           "method": "maintenance.create",
           "params": {
               "name": "Sunday maintenance",
               "active_since": 1358844540,
               "active_till": 1390466940,
               "tags_evaltype": 0,
               "groupids": [
               "timeperiods": [
                       "timeperiod_type": 3,
                       "every": 1,
                       "dayofweek": 64,
                       "start_time": 64800,
                       "period": 3600
               "tags": [
                       "tag": "service",
                       "operator": "0",
                       "value": "mysqld",
                       "tag": "error",
                       "operator": "2",
                       "value": ""
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1


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

See also


CMaintenance::create() in frontends/php/include/classes/api/services/CMaintenance.php.