Datadog Incidents Incident Update Attributes Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-structure/datadog-incidents-incident-update-attributes-structure.json",
  "name": "IncidentUpdateAttributes",
  "description": "Attributes to update on an existing incident",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The updated title of the incident",
      "example": "Example Monitor"
    },
    "state": {
      "type": "string",
      "description": "The updated state of the incident (transitioning to resolved records resolution time)",
      "enum": [
        "active",
        "stable",
        "resolved"
      ],
      "example": "active"
    },
    "severity": {
      "type": "string",
      "description": "The updated severity level of the incident",
      "enum": [
        "SEV-1",
        "SEV-2",
        "SEV-3",
        "SEV-4",
        "SEV-5",
        "UNKNOWN"
      ],
      "example": "SEV-1"
    },
    "customer_impacted": {
      "type": "boolean",
      "description": "Updated flag indicating whether the incident has customer impact",
      "example": true
    },
    "customer_impact_scope": {
      "type": "string",
      "description": "Updated description of the customer impact scope",
      "example": "example_value"
    },
    "customer_impact_end": {
      "type": "datetime",
      "description": "ISO 8601 timestamp when customer impact ended (set when marking impact as resolved)",
      "example": "example_value"
    },
    "fields": {
      "type": "object",
      "description": "Updated custom field values for the incident",
      "additionalProperties": {
        "type": "object"
      }
    },
    "notification_handles": {
      "type": "array",
      "description": "Updated list of notification handles for the incident",
      "items": {
        "type": "object"
      }
    }
  }
}