# event.acknowledge

### Description

`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.

### Parameters

`(string/array)` Parameters containing the IDs of the events acknowledge
and a message.

|Parameter|Type|Description|
|---------|----|-----------|
|**eventids**<br>(required)|string/object|IDs of the events to acknowledge.|
|message|string|Text of the acknowledgement message.|

::: notetip
Only trigger events with `value_changed` set to 1 can be
acknowledged.
:::

### Return values

`(object)` Returns an object containing the IDs of the acknowledged
events under the `eventids` property.

### Examples

#### Acknowledging an event

Acknowledge a single event and leave a message.

Request:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "message": "Problem resolved."
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            "20427"
        ]
    },
    "id": 1
}
```

### Source

CEvent::acknowledge() in *frontends/php/api/classes/CEvent.php*.