# Video Room Summary

## Complete

`com.twilio.video.insights.room-summary.complete`

Video Room Summary Complete events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/video/troubleshooting/insights).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.video.insights.room-summary.complete",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/VideoInsights.RoomSummaryApi/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "room_sid" : "RM0000000000000000000000000000001",
    "room_name" : "My room",
    "room_type" : "go",
    "account_sid" : "AC0000000000000000000000000000001",
    "create_time" : "2025-01-01T00:00:00.000Z",
    "end_time" : "2025-01-01T00:15:00.000Z",
    "duration_sec" : 248,
    "total_participant_duration_sec" : 465,
    "total_recording_duration_sec" : 464,
    "status" : "in-progress",
    "processing_state" : "complete",
    "created_method" : "api",
    "end_reason" : "disconnected_via_api",
    "max_participants_allowed" : 4,
    "participants" : 4,
    "unique_participant_identities" : 2,
    "max_concurrent_participants" : 2,
    "codecs" : [
      "VP8"
    ],
    "media_region" : "us1",
    "recording_enabled" : true,
    "detected_issues" : {
      "details" : [
        {
          "issue_type" : "packet_loss",
          "severity" : "high",
          "properties" : {
            "participant_sid" : "PA0000000000000000000000000000001",
            "participant_identity" : "00000000-0000-0000-0000-000000000001",
            "directions" : [
              "outbound"
            ]
          }
        }
      ]
    }
  }
}
```

**Versions**

#### v2 (latest)

> \[!NOTE]
>
> v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2.

* `string` **room\_sid** (required). Unique identifier for the room.
* `string` **room\_name** (required). Description of the room.
* `string` **room\_type** (required). The type of video room depending on size restrictions and technology implementations.
* `string` **account\_sid** (required). Account SID associated with this room.
* `string` **create\_time** (required). Datetime when the room was created in ISO-8601 format.
* `string` **end\_time** (required). Datetime when the room ended in ISO-8601 format.
* `integer` **duration\_sec**. Total room duration from create time to end time.
* `integer` **total\_participant\_duration\_sec**. Combined amount of participant time in the room.
* `integer` **total\_recording\_duration\_sec**. Combined amount of recorded seconds for participants in the room.
* `string` **status** (required). Status of the room.
* `string` **processing\_state** (required). Video Log Analyzer resource state. in-progress indicates that more details may be appended to the resource. complete indicates no further information will be added.
* `string` **created\_method** (required). How the room was created.
* `string` **end\_reason** (required). Reason the room ended.
* `integer` **max\_participants\_allowed**. Max number of total participants allowed by the application settings.
* `integer` **participants**. Number of participants. May include duplicate identities for participants who left and rejoined.
* `integer` **unique\_participant\_identities**. Unique number of participant identities.
* `integer` **max\_concurrent\_participants**. Maximum number of participants allowed in the room at the same time allowed by the application settings.
* `string[]` **codecs** (required). Video or Audio Codecs used by participants in the room.
* `string` **media\_region** (required). Region of Twilio media servers for the room.
* `boolean` **recording\_enabled** (required). Boolean indicating if recording is enabled for the room.
* `object` **detected\_issues**. Issues detected in a room.
  * `object[]` **details** (required). List of issues that occurred.
    * `string` **issue\_type** (required). The type of issue the participant experienced.
    * `string` **severity** (required). The severity of issue the participant experienced.
    * `object` **properties**. Detected issue that happened in the room.
      * `string` **participant\_sid**. Unique identifier for the participant that was impacted by the issue.
      * `string` **participant\_identity**. The application-defined string that uniquely identifies the participant within a Room.
      * `string[]` **directions** (required). The impacted audio/video direction.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/VideoInsights.RoomSummaryApi/2).

#### v1

* `string` **room\_sid** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **room\_name** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **room\_type** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **account\_sid** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **create\_time** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **end\_time** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **duration\_sec**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **total\_participant\_duration\_sec**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **total\_recording\_duration\_sec**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **status** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **processing\_state** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **created\_method** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **end\_reason** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **max\_participants\_allowed**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **participants**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **unique\_participant\_identities**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `integer` **max\_concurrent\_participants**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string[]` **codecs** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `string` **media\_region** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `boolean` **recording\_enabled** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
* `object` **detected\_issues**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
  * `object[]` **details** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
    * `string` **issue\_type** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
    * `string` **severity** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
    * `object` **properties**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
      * `string` **participant\_sid**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
      * `string` **participant\_identity**. Https://www.twilio.com/docs/video/insights/api/room-summary-resource.
      * `string[]` **directions** (required). Https://www.twilio.com/docs/video/insights/api/room-summary-resource.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/VideoInsights.RoomSummaryApi/1).