# Item object The following objects are directly related to the `item` API. ### Item ::: noteclassic Web items cannot be directly created, updated or deleted via the Zabbix API. ::: The item object has the following properties. |Property|Type|Description| |--------|----|-----------| |itemid|string|*(readonly)* ID of the item.| |**delay**
(required)|integer|Update interval of the item in seconds.| |**hostid**
(required)|string|ID of the host or template that the item belongs to.| |**interfaceid**
(required)|string|ID of the item's host interface.

Not required for template items. Optional for Zabbix agent (active), Zabbix internal, Zabbix trapper, Zabbix aggregate, database monitor and calculated items.| |**key\_**
(required)|string|Item key.| |**name**
(required)|string|Name of the item.| |**type**
(required)|integer|Type of the item.

Possible values:
0 - Zabbix agent;
1 - SNMPv1 agent;
2 - Zabbix trapper;
3 - simple check;
4 - SNMPv2 agent;
5 - Zabbix internal;
6 - SNMPv3 agent;
7 - Zabbix agent (active);
8 - Zabbix aggregate;
9 - web item;
10 - external check;
11 - database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
15 - calculated;
16 - JMX agent;
17 - SNMP trap.| |**value\_type**
(required)|integer|Type of information of the item.

Possible values:
0 - numeric float;
1 - character;
2 - log;
3 - numeric unsigned;
4 - text.| |authtype|integer|SSH authentication method. Used only by SSH agent items.

Possible values:
0 - *(default)* password;
1 - public key.| |data\_type|integer|Data type of the item.

Possible values:
0 - *(default)* decimal;
1 - octal;
2 - hexadecimal;
3 - boolean.| |delay\_flex|string|Flexible intervals as a serialized string.

Each serialized flexible interval consists of an update interval and a [time period](/manual/appendix/time_period) separated by a forward slash. Multiple intervals are separated by a colon.| |delta|integer|Value that will be stored.

Possible values:
0 - *(default)* as is;
1 - Delta, speed per second;
2 - Delta, simple change.| |description|string|Description of the item.| |error|string|*(readonly)* Error text if there are problems updating the item.| |flags|integer|*(readonly)* Origin of the item.

Possible values:
0 - a plain item;
4 - a discovered item.| |formula|integer/float|Custom multiplier.

Default: 1.| |history|integer|Number of days to keep item's history data.

Default: 90.| |inventory\_link|integer|ID of the host inventory field that is populated by the item.

Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.

Default: 0.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI items.| |lastclock|timestamp|*(readonly)* Time when the item was last updated.

This property will only return a value for the period configured in [ZBX\_HISTORY\_PERIOD](/manual/web_interface/definitions).| |lastns|integer|*(readonly)* Nanoseconds when the item was last updated.

This property will only return a value for the period configured in [ZBX\_HISTORY\_PERIOD](/manual/web_interface/definitions).| |lastvalue|string|*(readonly)* Last value of the item.

This property will only return a value for the period configured in [ZBX\_HISTORY\_PERIOD](/manual/web_interface/definitions).| |logtimefmt|string|Format of the time in log entries. Used only by log items.| |mtime|timestamp|Time when the monitored log file was last updated. Used only by log items.| |multiplier|integer|Whether to use a custom multiplier.| |params|string|Additional parameters depending on the type of the item:
- executed script for SSH and Telnet items;
- SQL query for database monitor items;
- formula for calculated items.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor and JMX items.| |port|string|Port monitored by the item. Used only by SNMP items.| |prevvalue|string|*(readonly)* Previous value of the item.

This property will only return a value for the period configured in [ZBX\_HISTORY\_PERIOD](/manual/web_interface/definitions).| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |snmp\_community|string|SNMP community. Used only by SNMPv1 and SNMPv2 items.| |snmp\_oid|string|SNMP OID.| |snmpv3\_authpassphrase|string|SNMPv3 auth passphrase. Used only by SNMPv3 items.| |snmpv3\_authprotocol|integer|SNMPv3 authentication protocol. Used only by SNMPv3 items.

Possible values:
0 - *(default)* MD5;
1 - SHA.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 items.| |snmpv3\_privpassphrase|string|SNMPv3 priv passphrase. Used only by SNMPv3 items.| |snmpv3\_privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 items.

Possible values:
0 - *(default)* DES;
1 - AES.| |snmpv3\_securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 items.

Possible values:
0 - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.| |snmpv3\_securityname|string|SNMPv3 security name. Used only by SNMPv3 items.| |state|integer|*(readonly)* State of the item.

Possible values:
0 - *(default)* normal;
1 - not supported.| |status|integer|Status of the item.

Possible values:
0 - *(default)* enabled item;
1 - disabled item.| |templateid|string|(readonly) ID of the parent template item.

*Hint*: Use the `hostid` property to specify the template that the item belongs to.| |trapper\_hosts|string|Allowed hosts. Used only by trapper items.| |trends|integer|Number of days to keep item's trends data.

Default: 365.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor and JMX items.

Required by SSH and Telnet items.| |valuemapid|string|ID of the associated value map.|