Add documentation for POST api/v2/incidents/import

config/_default/menus/api.en.yaml

@@ -8971,6 +8971,19 @@ menu:
         unstable:
           - v2
         order: 6
+    - name: Import an incident
+      url: '#import-an-incident'
+      identifier: incidents-import-an-incident
+      parent: incidents
+      generated: true
+      params:
+        versions:
+          - v2
+        operationids:
+          - ImportIncident
+        unstable:
+          - v2
+        order: 49
     - name: Update an incident type
       url: '#update-an-incident-type'
       identifier: incidents-update-an-incident-type

content/en/api/v2/incidents/request.ImportIncident.json

@@ -0,0 +1,19 @@
+{
+  "data": {
+    "type": "incidents",
+    "attributes": {
+      "declared": "2025-01-01T00:00:00Z",
+      "detected": "2025-01-01T00:00:00Z",
+      "fields": {
+        "severity": {
+          "value": "SEV-5"
+        },
+        "state": {
+          "value": "active"
+        }
+      },
+      "title": "Example-Incident",
+      "visibility": "organization"
+    }
+  }
+}

data/api/v2/CodeExamples.json

@@ -859,6 +859,13 @@
       "description": "Create incident notification template returns \"Created\" response"
     }
   ],
+  "ImportIncident": [
+    {
+      "group": "incidents",
+      "suffix": "",
+      "description": "Import an incident returns \"CREATED\" response"
+    }
+  ],
   "UpdateIncidentIntegration": [
     {
       "group": "incidents",