object event.acknowledge(string/array parameters)
This method allows to acknowledge events and add an acknowledgement message. If an event is already acknowledged, a new message will still be added.
(string/array)
Parameters containing the IDs of the events acknowledge and a message.
Parameter | Type | Description |
---|---|---|
eventids (required) |
string/object | IDs of the events to acknowledge. |
message | string | Text of the acknowledgement message. |
Only trigger events with value_changed
set to 1 can be acknowledged.
(object)
Returns an object containing the IDs of the acknowledged events under the eventids
property.
Acknowledge a single event and leave a message.
Request:
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": "20427",
"message": "Problem resolved."
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
Response:
CEvent::acknowledge() in frontends/php/api/classes/CEvent.php.