[comment]: # aside:1
[comment]: # ({195463c3-8bbba5df})
# Trigger object
The following objects are directly related to the `trigger` API.
[comment]: # ({/195463c3-8bbba5df})
[comment]: # ({44461ee2-db828bca})
### Trigger
The trigger object has the following properties.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|triggerid|ID|ID of the trigger.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*
- *required* for update operations|
|description|string|Name of the trigger.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|expression|string|Trigger expression.
Items with `value_type` set to `5` (binary) cannot be used in trigger expressions.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|event\_name|string|Event name generated by the trigger.|
|opdata|string|Operational data.|
|comments|string|Additional description of the trigger.|
|error|string|Error text if there have been any problems when updating the state of the trigger.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|flags|integer|[Origin](/manual/api/reference_commentary#entity-origin-flags) of the trigger.
Possible values:
0 - *(default)* a plain trigger;
4 - a trigger converted from prototype.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|lastchange|timestamp|Time when the trigger last changed its state.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|priority|integer|Severity of the trigger.
Possible values:
0 - *(default)* not classified;
1 - information;
2 - warning;
3 - average;
4 - high;
5 - disaster.|
|state|integer|State of the trigger.
Possible values:
0 - *(default)* trigger state is up to date;
1 - current trigger state is unknown.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|status|integer|Whether the trigger is enabled or disabled.
Possible values:
0 - *(default)* enabled;
1 - disabled.|
|templateid|ID|ID of the parent template trigger.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|type|integer|Whether the trigger can generate multiple problem events.
Possible values:
0 - *(default)* do not generate multiple events;
1 - generate multiple events.|
|url|string|URL associated with the trigger.|
|url_name|string|Label for the URL associated with the trigger.|
|value|integer|Whether the trigger is in OK or problem state.
Possible values:
0 - *(default)* OK;
1 - problem.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|recovery\_mode|integer|OK event generation mode.
Possible values:
0 - *(default)* Expression;
1 - Recovery expression;
2 - None.|
|recovery\_expression|string|Trigger recovery expression.
Items with `value_type` set to `5` (binary) cannot be used in trigger recovery expressions.|
|correlation\_mode|integer|OK event closes.
Possible values:
0 - *(default)* All problems;
1 - All problems if tag values match.|
|correlation\_tag|string|Tag for matching.|
|manual\_close|integer|Allow manual close.
Possible values:
0 - *(default)* No;
1 - Yes.|
|uuid|string|Universal unique identifier, used for linking imported triggers to already existing ones. Auto-generated, if not given.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *supported* if the trigger belongs to a template|
[comment]: # ({/44461ee2-db828bca})
[comment]: # ({5a130da9-0188f389})
### Trigger tag
The trigger tag object has the following properties.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Trigger tag name.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|value|string|Trigger tag value.|
[comment]: # ({/5a130da9-0188f389})