delete()

Available since version: 1.8
This function allows you to delete information about one or several hosts. All host-related information will be removed including items, graphs, macros, application, historical data, etc.

Parameters

Array of Host IDs

Returns

Parameter Description
result Operation successful. Result will contain array of deleted Host IDs.
error In case of any errors

Example

Delete hosts by Host ID

{
"jsonrpc":"2.0",
"method":"host.delete",
"params":[
      {
         "hostid":"107824"
      },
      {
         "hostid":"107825"
      }
],
"auth":"3a57200802b24cda67c4e4010b50c065",
"id":2
}

Hosts deleted successfully:

{
"jsonrpc":"2.0",
"result":{
   "hostids": ["107824", "107825"]
},
"id":2
}

Host does not exist:

{
"jsonrpc":"2.0",
"error":{
      "code":-32500,
      "message":"Application error.",
      "data":"[ CHost::delete ] Host does not exist"
},
"id":2
}