Incidents

Import an incident

Import an incident from an external system. This endpoint allows you to create incidents with historical data such as custom timestamps for detection, declaration, and resolution. Imported incidents do not execute integrations or notification rules.

post/api/v2/incidents/import

Request

Base URL
https://api.datadoghq.com
URL
https://api.datadoghq.com/api/v2/incidents/import
Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2
  Authorization code: /oauth2/v1/authorize
  Token URL: /oauth2/v1/token scopes: incident_write

Query parameters

includeIncidentImportRelatedObject[]

Specifies which related object types to include in the response when importing an incident.

Request body

Example request

{
  "data": {
    "attributes": {
      "declared": "2025-01-01T00:00:00Z",
      "detected": "2025-01-01T00:00:00Z",
      "fields": {
        "severity": {
          "value": "SEV-5"
        },
        "state": {
          "value": "active"
        }
      },
      "incident_type_uuid": "00000000-0000-0000-0000-000000000000",
      "resolved": "2025-01-01T01:00:00Z",
      "title": "Imported incident from external system",
      "visibility": "organization"
    },
    "relationships": {
      "commander_user": {
        "data": {
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "users"
        }
      },
      "declared_by_user": {
        "data": {
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "users"
        }
      }
    },
    "type": "incidents"
  }
}

Response

CREATED

Example response

{
  "data": {
    "attributes": {
      "created": "2025-01-01T00:00:00Z",
      "customer_impact_scope": "An example customer impact scope",
      "declared": "2025-01-01T00:00:00Z",
      "detected": "2025-01-01T00:00:00Z",
      "fields": {
        "severity": {
          "type": "dropdown",
          "value": "SEV-5"
        }
      },
      "incident_type_uuid": "00000000-0000-0000-0000-000000000000",
      "notification_handles": [
        {
          "display_name": "Jane Doe",
          "handle": "@test.user@test.com"
        }
      ],
      "public_id": 1,
      "severity": "UNKNOWN",
      "title": "A test incident title"
    },
    "id": "00000000-0000-0000-1234-000000000000",
    "relationships": {
      "attachments": {
        "data": [
          {
            "id": "00000000-0000-abcd-1000-000000000000",
            "type": "incident_attachments"
          }
        ]
      },
      "commander_user": {
        "data": {
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "users"
        }
      },
      "created_by_user": {
        "data": {
          "id": "00000000-0000-0000-2345-000000000000",
          "type": "users"
        }
      },
      "declared_by_user": {
        "data": {
          "id": "00000000-0000-0000-2345-000000000000",
          "type": "users"
        }
      },
      "impacts": {
        "data": [
          {
            "id": "00000000-0000-0000-2345-000000000000",
            "type": "incident_impacts"
          }
        ]
      },
      "incident_type": {
        "data": {
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "incident_types"
        }
      },
      "integrations": {
        "data": [
          {
            "id": "00000000-abcd-0005-0000-000000000000",
            "type": "incident_integrations"
          },
          {
            "id": "00000000-abcd-0006-0000-000000000000",
            "type": "incident_integrations"
          }
        ]
      },
      "last_modified_by_user": {
        "data": {
          "id": "00000000-0000-0000-2345-000000000000",
          "type": "users"
        }
      },
      "responders": {
        "data": [
          {
            "id": "00000000-0000-0000-2345-000000000000",
            "type": "incident_responders"
          }
        ]
      },
      "user_defined_fields": {
        "data": [
          {
            "id": "00000000-0000-0000-2345-000000000000",
            "type": "user_defined_field"
          }
        ]
      }
    },
    "type": "incidents"
  },
  "included": [
    {
      "type": "users"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.