From c80383dd1a92a6fd5da935f5cd315e854292bbfc Mon Sep 17 00:00:00 2001
From: Pedro Silva <pedro@acryl.io>
Date: Wed, 24 Jan 2024 21:45:00 +0000
Subject: [PATCH] feat(docs): Add documentation on Incident Change Event
 (#9709)

---
 .../datahub-api/entity-events-api.md          | 36 +++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/docs/managed-datahub/datahub-api/entity-events-api.md b/docs/managed-datahub/datahub-api/entity-events-api.md
index 07fa252249..23499904d5 100644
--- a/docs/managed-datahub/datahub-api/entity-events-api.md
+++ b/docs/managed-datahub/datahub-api/entity-events-api.md
@@ -563,7 +563,7 @@ This event is emitted when an Assertion has been run has succeeded on DataHub.
   "parameters": {
     "runResult": "SUCCESS",
     "runId": "123",
-    "aserteeUrn": "urn:li:dataset:def"
+    "asserteeUrn": "urn:li:dataset:def"
   },
   "auditStamp": {
     "actor": "urn:li:corpuser:jdoe",
@@ -808,4 +808,36 @@ These are the common parameters for all parameters.
     "time": 1649953100653   
   }
 }
-```
\ No newline at end of file
+```
+
+### Incident Change Event
+
+This event is emitted when an Incident has been created or it's status changes.
+
+#### Header
+
+<table><thead><tr><th>Category</th><th>Operation</th><th>Entity Types</th><th data-hidden></th></tr></thead><tbody><tr><td>INCIDENT</td><td><code>ACTIVE, </code><code>RESOLVED</code></td><td><code>incident</code></td><td></td></tr></tbody></table>
+
+#### Parameters
+
+| Name         | Type   | Description                                       | Optional |
+|--------------| ------ |---------------------------------------------------| -------- |
+| entities     | String | The list of entities associated with the incident | False    |
+
+#### Sample Event
+
+```
+{
+  "entityUrn": "urn:li:incident:16ff200a-0ac5-4a7d-bbab-d4bdb4f831f9",
+  "entityType": "incident",
+  "category": "INCIDENT",
+  "operation": "ACTIVE",
+  "parameters": {
+    "entities": "[urn:li:dataset:abc, urn:li:dataset:abc2]",
+  },
+  "auditStamp": {
+    "actor": "urn:li:corpuser:jdoe",
+    "time": 1649953100653   
+  }
+}
+```