You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

item.delete

Description

object item.delete(array itemIds)

This method allows to delete items.

Web items cannot be deleted via the Zabbix API.

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

Parameters

(array) IDs of the items to delete.

Return values

(object) Returns an object containing the IDs of the deleted items under the itemids property.

Examples

Deleting multiple items

Delete two items.
Dependent items and item prototypes are removed automatically if master item is deleted.

Request:

{
           "jsonrpc": "2.0",
           "method": "item.delete",
           "params": [
               "22982",
               "22986"
           ],
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "itemids": [
                   "22982",
                   "22986"
               ]
           },
           "id": 1
       }

Source

CItem::delete() in ui/include/classes/api/services/CItem.php.