---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event-instance.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/event-instance.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event-instance.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/en/llms.txt?revision=r21995741

# List of functions

The `event` property has functions. Each function describes a specific type of event and has a number of acceptable values, which are events of the specified type that the sensor can transmit.

#|
||
**Function**
|
**Description**
||

||
[vibration](#vibration)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/vibration-p.md -->
Displaying events of physical interaction: vibrating, falling, tilting.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/vibration-p.md -->
||

||
[open](#open)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/open-p.md -->
Displaying events for opening/closing doors, windows, and so on.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/open-p.md -->
||

||
[button](#button)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/button-p.md -->
Displaying button click events.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/button-p.md -->
||

||
[motion](#motion)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/motion-p.md -->
Displaying events relating to movement detection in the sensor range.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/motion-p.md -->
||

||
[smoke](#smoke)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/smoke-p.md -->
Displaying smoke detection events in the room.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/smoke-p.md -->
||

||
[gas](#gas)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/gas-p.md -->
Displaying gas detection events in the room.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/gas-p.md -->
||

||
[battery_level](#battery_level)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/battery_level-p.md -->
Displaying battery charge events.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/battery_level-p.md -->
||

||
[food_level](#food_level)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/food_level-p.md -->
Displaying events related to the pet food level.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/food_level-p.md -->
||

||
[water_level](#water_level)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/water_level-p.md -->
Displaying events relating to the water level.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/water_level-p.md -->
||

||
[water_leak](#water_leak)
|
<!-- source: en/_includes/concepts/event-instance/id-event-instance/water_leak-p.md -->
Displaying water leak events.
<!-- endsource: en/_includes/concepts/event-instance/id-event-instance/water_leak-p.md -->
||
|#


### vibration {#vibration}

Displaying events of physical interaction: vibrating, falling, tilting.


{% list tabs %}

- Specifications


  Below is a description of the `vibration` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `vibration`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value

  |

  [String](*string)

  |

  Function name for the property. Acceptable values:
  - `tilt` — Tilting.
  - `fall` — Falling.
  - `vibration` — Vibrating.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->

  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "vibration",
      "events": [{
          "value": "tilt"
        },
        {
          "value": "fall"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the vibration function**

  1. [devices.types.sensor.vibration](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-vibration.md)

{% endlist %}

### open {#open}

Displaying events for opening/closing doors, windows, and so on.


{% list tabs %}

- Specifications


  Below is a description of the `open` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `open`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `opened` — Open.
  - `closed` — Closed.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->


  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "open",
      "events": [{
          "value": "opened"
        },
        {
          "value": "closed"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the open function**
  
  1. [devices.types.sensor.open](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-open.md)
  1. [devices.types.openable](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-openable.md)
  1. [devices.types.openable.curtain](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-openable-curtain.md)

{% endlist %}

### button {#button}

Displaying button click events.


{% list tabs %}

- Specifications


  Below is a description of the `button` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `button`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `click` — Single press.
  - `double_click` — Double press.
  - `long_press` — Long press.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "button",
      "events": [{
          "value": "click"
        },
        {
          "value": "double_click"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the button function**

  1. [devices.types.sensor.button](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-button.md)

{% endlist %}

### motion {#motion}

Displaying events relating to movement detection in the sensor range.


{% list tabs %}

- Specifications


  Below is a description of the `motion` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `motion`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `detected` — Detected.
  - `not_detected` — Not detected.
  ||

  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "motion",
      "events": [{
          "value": "detected"
        },
        {
          "value": "not_detected"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the motion function**

  1. [devices.types.sensor.motion](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-motion.md)

{% endlist %}

### smoke {#smoke}

Displaying smoke detection events in the room.


{% list tabs %}

- Specifications


  Below is a description of the `smoke` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `smoke`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `detected` — Detected.
  - `not_detected` — Not detected.
  - `high` — High level.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
      ...
      "parameters": {
          "instance": "smoke",
          "events": [{
              "value": "detected"
          },
          {
              "value": "not_detected"
          }]
      }
      ...
  }
  ```

  **Examples of devices with the smoke function**

  1. [devices.types.sensor.smoke](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-smoke.md)

{% endlist %}

### gas {#gas}

Displaying gas detection events in the room.


{% list tabs %}

- Specifications


  Below is a description of the `gas` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `gas`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `detected` — Detected.
  - `not_detected` — Not detected.
  - `high` — High level.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "gas",
      "events": [{
          "value": "detected"
        },
        {
          "value": "not_detected"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the gas function**

  1. [devices.types.sensor.gas](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-gas.md)

{% endlist %}

### battery_level {#battery_level}

Displaying battery charge events.


{% list tabs %}

- Specifications


  Below is a description of the `battery_level` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `battery_level`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `low` — Low.
  - `normal` — Normal.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "battery_level",
      "events": [{
          "value": "low"
        },
        {
          "value": "normal"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the battery_level function**

  1. [devices.types.sensor](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor.md)

  1. [devices.types.vacuum_cleaner](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-vacuum-cleaner.md)

{% endlist %}

### food_level {#food_level}

Displaying events related to the pet food level.


{% list tabs %}

- Specifications


  Below is a description of the `food_level` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `food_level`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `empty` — Empty.
  - `low` — Low.
  - `normal` — Normal.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "food_level",
      "events": [{
          "value": "empty"
        },
        {
          "value": "low"
        },
        {
          "value": "normal"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the food_level function**

  1. [devices.types.pet_feeder](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-pet-feeder.md)

{% endlist %}

### water_level {#water_level}

Displaying events relating to the water level.


{% list tabs %}

- Specifications


  Below is a description of the `water_level` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `water_level`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `empty` — Empty.
  - `low` — Low.
  - `normal` — Normal.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "water_level",
      "events": [{
          "value": "empty"
        },
        {
          "value": "low"
        },
        {
          "value": "normal"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the water_level function**

  1. [devices.types.sensor](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor.md)
  1. [devices.types.cooking.coffee_maker](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-cooking-coffee-maker.md)
  1. [devices.types.cooking.kettle](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-cooking-kettle.md)
  1. [devices.types.pet_drinking_fountain](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-pet-drinking-fountain.md)
  1. [devices.types.humidifier](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-humidifier.md)
  1. [devices.types.vacuum_cleaner](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-vacuum-cleaner.md)

{% endlist %}

### water_leak {#water_leak}

Displaying water leak events.


{% list tabs %}

- Specifications


  Below is a description of the `water_leak` object from the [Property description](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#discovery) section.

  **`parameters` object**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  instance
  |
  [String](*string)
  |
  Function name for the property. Acceptable values: `water_leak`.
  ||

  ||
  events
  |
  [Array](*array) of event objects
  |
  <!-- source: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  Array of `event` objects that describe events supported by the property. Minimum number of events in the array: 1.
  <!-- endsource: en/_includes/reference/struct-table/id-struct-table/events-p.md -->
  ||
  |#

  **The `event` object that is a part of the `events` array**

  #|
  ||
  **Parameter**
  |
  **Type**
  |
  **Description**
  ||

  ||
  value
  |
  [String](*string)
  |
  Function name for the property. Acceptable values:
  - `dry` — There's no leak.
  - `leak` — There's a leak.
  ||
  |#



- Examples of use


  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->
  Use this function to describe the features of various devices:
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-p.md -->


  **Example of the `parameters` object**

  <!-- source: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->
  See the full example in [Example of use](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md#example).
  <!-- endsource: en/_includes/concepts/event-instance/id-event-instance/example-parameters.md -->

  ```json translate=no
  {
    ...
    "parameters": {
      "instance": "water_leak",
      "events": [{
          "value": "dry"
        },
        {
          "value": "leak"
        }
      ]
    }
    ...
  }
  ```

  **Examples of devices with the water_leak function**

  1. [devices.types.sensor.water_leak](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-type-sensor-water_leak.md)

{% endlist %}

<!-- {% include [support-support-button](../_includes/about/id-support/support-button.md) %}-->

[*string]:
  String enclosed in quotation marks, for example: `"Hello, world"`.

[*array]:
  An array of elements separated by a comma. As array items, you can use standard JSON elements: a string, number, `true`, `false`, object, or array. Arrays are enclosed in square brackets `[]`:

```json translate=no
"cities": ["Moscow", "Tokyo", "New York"]
```