---
title: 인시던트 가져오기
description: 외부 시스템에서 인시던트를 가져옵니다. 이 엔드포인트를 사용하면 탐지, 선언 및 해결을 위한 사용자 지정 타임스탬프와 같은 과거 데이터를 포함하여 인시던트를 생성할 수 있습니다. 가져온 인시던트는 통합 또는 알림 규칙을 실행하지 않습니다.
breadcrumbs: 문서 > API > 인시던트 가져오기
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt).

# 인시던트 가져오기

## v2 (latest)

{% alert level="warning" %}
**Note**: This endpoint is in Preview.
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help.md).
{% /alert %}

| Datadog site      | API endpoint                                               |
| ----------------- | ---------------------------------------------------------- |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/incidents/import     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/incidents/import |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/incidents/import |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/incidents/import      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/incidents/import |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/incidents/import |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/incidents/import |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/incidents/import      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/incidents/import  |

### Overview

외부 시스템에서 인시던트를 가져옵니다. 이 엔드포인트를 사용하면 탐지, 선언 및
해결을 위한 사용자 지정 타임스탬프와 같은 과거 데이터를 포함하여 인시던트를 생성할 수 있습니다.
가져온 인시던트는 통합 또는 알림 규칙을 실행하지 않습니다.

This endpoint requires the `incident_write` permission.

OAuth apps require the `incident_write` authorization [scope](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/api/latest/scopes.md#incidents) to access this endpoint.

### Arguments

#### Query Strings

| Field   | Type  | Description                                                                                 |
| ------- | ----- | ------------------------------------------------------------------------------------------- |
| include | array | Specifies which related object types to include in the response when importing an incident. |

### Request

#### Body Data (required)

인시던트 가져오기 페이로드입니다.

{% tabs %}
{% tab label="Model" %}
| Parent field         | Field                   | Type      | Description                                                                                                |
| -------------------- | ----------------------- | --------- | ---------------------------------------------------------------------------------------------------------- |
|                      | data [*required*]       | object    | 인시던트에 대한 가져오기 요청입니다. 외부 시스템에서 과거 인시던트를 가져오는 데 사용됩니다.                                                       |
| data                 | attributes [*required*] | object    | The incident's attributes for an import request.                                                           |
| attributes           | declared                | date-time | Timestamp when the incident was declared.                                                                  |
| attributes           | detected                | date-time | Timestamp when the incident was detected.                                                                  |
| attributes           | fields                  | object    | A condensed view of the user-defined fields for which to create initial selections.                        |
| additionalProperties | <any-key>               | <oneOf>   | Dynamic fields for which selections can be made, with field names as keys.                                 |
| <any-key>            | Object 1                | object    | A field with a single value selected.                                                                      |
| Object 1             | value                   | string    | The single value selected for this field.                                                                  |
| <any-key>            | Object 2                | object    | A field with potentially multiple values selected.                                                         |
| Object 2             | value                   | [string]  | The multiple values selected for this field.                                                               |
| attributes           | incident_type_uuid      | string    | A unique identifier that represents the incident type. If not provided, the default incident type is used. |
| attributes           | resolved                | date-time | Timestamp when the incident was resolved. Can only be set when the state field is set to 'resolved'.       |
| attributes           | title [*required*]      | string    | The title of the incident that summarizes what happened.                                                   |
| attributes           | visibility              | enum      | The visibility of the incident. Allowed enum values: `organization`, `private`. Default: `organization`.   |
| data                 | relationships           | object    | The relationships for an incident import request.                                                          |
| relationships        | commander_user          | object    | Relationship to user.                                                                                      |
| commander_user       | data [*required*]       | object    | Relationship to user object.                                                                               |
| data                 | id [*required*]         | string    | A unique identifier that represents the user.                                                              |
| data                 | type [*required*]       | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                       |
| relationships        | declared_by_user        | object    | Relationship to user.                                                                                      |
| declared_by_user     | data [*required*]       | object    | Relationship to user object.                                                                               |
| data                 | id [*required*]         | string    | A unique identifier that represents the user.                                                              |
| data                 | type [*required*]       | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                       |
| data                 | type [*required*]       | enum      | Incident resource type. Allowed enum values: `incidents`. Default: `incidents`.                            |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "type": "incidents",
    "attributes": {
      "title": "Example-Incident",
      "visibility": "organization"
    }
  }
}
```
{% /tab %}
{% /tabs %}

### Response

{% tabs %}
{% tab label="201" %}
CREATED

{% tabs %}
{% tab label="Model" %}
Response with an incident.

| Parent field                  | Field                         | Type      | Description                                                                                                                                                                                                                                                           |
| ----------------------------- | ----------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|                               | data [*required*]             | object    | Incident data from an import response.                                                                                                                                                                                                                                |
| data                          | attributes                    | object    | The incident's attributes from an import response.                                                                                                                                                                                                                    |
| attributes                    | archived                      | date-time | Timestamp when the incident was archived. Read-only.                                                                                                                                                                                                                  |
| attributes                    | case_id                       | int64     | The incident case ID.                                                                                                                                                                                                                                                 |
| attributes                    | created                       | date-time | Timestamp when the incident was created. Read-only.                                                                                                                                                                                                                   |
| attributes                    | created_by_uuid               | string    | UUID of the user who created the incident.                                                                                                                                                                                                                            |
| attributes                    | creation_idempotency_key      | string    | A unique key used to ensure idempotent incident creation.                                                                                                                                                                                                             |
| attributes                    | customer_impact_end           | date-time | Timestamp when customers were no longer impacted by the incident.                                                                                                                                                                                                     |
| attributes                    | customer_impact_scope         | string    | A summary of the impact customers experienced during the incident.                                                                                                                                                                                                    |
| attributes                    | customer_impact_start         | date-time | Timestamp when customers began to be impacted by the incident.                                                                                                                                                                                                        |
| attributes                    | declared                      | date-time | Timestamp when the incident was declared.                                                                                                                                                                                                                             |
| attributes                    | declared_by_uuid              | string    | UUID of the user who declared the incident.                                                                                                                                                                                                                           |
| attributes                    | detected                      | date-time | Timestamp when the incident was detected.                                                                                                                                                                                                                             |
| attributes                    | fields                        | object    | A condensed view of the user-defined fields attached to incidents.                                                                                                                                                                                                    |
| additionalProperties          | <any-key>                     | <oneOf>   | Dynamic fields for which selections can be made, with field names as keys.                                                                                                                                                                                            |
| <any-key>                     | Object 1                      | object    | A field with a single value selected.                                                                                                                                                                                                                                 |
| Object 1                      | type                          | enum      | Type of the single value field definitions. Allowed enum values: `dropdown`, `textbox`. Default: `dropdown`.                                                                                                                                                          |
| Object 1                      | value                         | string    | The single value selected for this field.                                                                                                                                                                                                                             |
| <any-key>                     | Object 2                      | object    | A field with potentially multiple values selected.                                                                                                                                                                                                                    |
| Object 2                      | type                          | enum      | Type of the multiple value field definitions. Allowed enum values: `multiselect`, `textarray`, `metrictag`, `autocomplete`. Default: `multiselect`.                                                                                                                   |
| Object 2                      | value                         | [string]  | The multiple values selected for this field.                                                                                                                                                                                                                          |
| attributes                    | incident_type_uuid            | string    | A unique identifier that represents an incident type.                                                                                                                                                                                                                 |
| attributes                    | is_test                       | boolean   | A flag indicating whether the incident is a test incident.                                                                                                                                                                                                            |
| attributes                    | last_modified_by_uuid         | string    | UUID of the user who last modified the incident.                                                                                                                                                                                                                      |
| attributes                    | modified                      | date-time | Timestamp when the incident was last modified. Read-only.                                                                                                                                                                                                             |
| attributes                    | non_datadog_creator           | object    | Incident's non Datadog creator.                                                                                                                                                                                                                                       |
| non_datadog_creator           | image_48_px                   | string    | Non Datadog creator `48px` image.                                                                                                                                                                                                                                     |
| non_datadog_creator           | name                          | string    | Non Datadog creator name.                                                                                                                                                                                                                                             |
| attributes                    | notification_handles          | [object]  | Notification handles that are notified of the incident during update.                                                                                                                                                                                                 |
| notification_handles          | display_name                  | string    | The name of the notified handle.                                                                                                                                                                                                                                      |
| notification_handles          | handle                        | string    | The handle used for the notification. This includes an email address, Slack channel, or workflow.                                                                                                                                                                     |
| attributes                    | public_id                     | int64     | The monotonically increasing integer ID for the incident.                                                                                                                                                                                                             |
| attributes                    | resolved                      | date-time | Timestamp when the incident's state was last changed from active or stable to resolved or completed.                                                                                                                                                                  |
| attributes                    | severity                      | enum      | The incident severity. Allowed enum values: `UNKNOWN`, `SEV-0`, `SEV-1`, `SEV-2`, `SEV-3`, `SEV-4`, `SEV-5`.                                                                                                                                                          |
| attributes                    | state                         | string    | The state of the incident.                                                                                                                                                                                                                                            |
| attributes                    | title [*required*]            | string    | The title of the incident that summarizes what happened.                                                                                                                                                                                                              |
| attributes                    | visibility                    | string    | The incident visibility status.                                                                                                                                                                                                                                       |
| data                          | id [*required*]               | string    | The incident's ID.                                                                                                                                                                                                                                                    |
| data                          | relationships                 | object    | The incident's relationships from an import response.                                                                                                                                                                                                                 |
| relationships                 | attachments                   | object    | A relationship reference for attachments.                                                                                                                                                                                                                             |
| attachments                   | data [*required*]             | [object]  | An array of incident attachments.                                                                                                                                                                                                                                     |
| data                          | id [*required*]               | string    | A unique identifier that represents the attachment.                                                                                                                                                                                                                   |
| data                          | type [*required*]             | enum      | The incident attachment resource type. Allowed enum values: `incident_attachments`. Default: `incident_attachments`.                                                                                                                                                  |
| relationships                 | commander_user                | object    | Relationship to user.                                                                                                                                                                                                                                                 |
| commander_user                | data [*required*]             | object    | Relationship to user object.                                                                                                                                                                                                                                          |
| data                          | id [*required*]               | string    | A unique identifier that represents the user.                                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| relationships                 | created_by_user               | object    | Relationship to user.                                                                                                                                                                                                                                                 |
| created_by_user               | data [*required*]             | object    | Relationship to user object.                                                                                                                                                                                                                                          |
| data                          | id [*required*]               | string    | A unique identifier that represents the user.                                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| relationships                 | declared_by_user              | object    | Relationship to user.                                                                                                                                                                                                                                                 |
| declared_by_user              | data [*required*]             | object    | Relationship to user object.                                                                                                                                                                                                                                          |
| data                          | id [*required*]               | string    | A unique identifier that represents the user.                                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| relationships                 | impacts                       | object    | Relationship to impacts.                                                                                                                                                                                                                                              |
| impacts                       | data [*required*]             | [object]  | An array of incident impacts.                                                                                                                                                                                                                                         |
| data                          | id [*required*]               | string    | A unique identifier that represents the impact.                                                                                                                                                                                                                       |
| data                          | type [*required*]             | enum      | The incident impacts type. Allowed enum values: `incident_impacts`.                                                                                                                                                                                                   |
| relationships                 | incident_type                 | object    | Relationship to an incident type.                                                                                                                                                                                                                                     |
| incident_type                 | data [*required*]             | object    | Relationship to incident type object.                                                                                                                                                                                                                                 |
| data                          | id [*required*]               | string    | The incident type's ID.                                                                                                                                                                                                                                               |
| data                          | type [*required*]             | enum      | Incident type resource type. Allowed enum values: `incident_types`. Default: `incident_types`.                                                                                                                                                                        |
| relationships                 | integrations                  | object    | A relationship reference for multiple integration metadata objects.                                                                                                                                                                                                   |
| integrations                  | data [*required*]             | [object]  | Integration metadata relationship array                                                                                                                                                                                                                               |
| data                          | id [*required*]               | string    | A unique identifier that represents the integration metadata.                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Integration metadata resource type. Allowed enum values: `incident_integrations`. Default: `incident_integrations`.                                                                                                                                                   |
| relationships                 | last_modified_by_user         | object    | Relationship to user.                                                                                                                                                                                                                                                 |
| last_modified_by_user         | data [*required*]             | object    | Relationship to user object.                                                                                                                                                                                                                                          |
| data                          | id [*required*]               | string    | A unique identifier that represents the user.                                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| relationships                 | responders                    | object    | Relationship to incident responders.                                                                                                                                                                                                                                  |
| responders                    | data [*required*]             | [object]  | An array of incident responders.                                                                                                                                                                                                                                      |
| data                          | id [*required*]               | string    | A unique identifier that represents the responder.                                                                                                                                                                                                                    |
| data                          | type [*required*]             | enum      | The incident responders type. Allowed enum values: `incident_responders`.                                                                                                                                                                                             |
| relationships                 | user_defined_fields           | object    | Relationship to incident user defined fields.                                                                                                                                                                                                                         |
| user_defined_fields           | data [*required*]             | [object]  | An array of user defined fields.                                                                                                                                                                                                                                      |
| data                          | id [*required*]               | string    | A unique identifier that represents the responder.                                                                                                                                                                                                                    |
| data                          | type [*required*]             | enum      | The incident user defined fields type. Allowed enum values: `user_defined_field`.                                                                                                                                                                                     |
| data                          | type [*required*]             | enum      | Incident resource type. Allowed enum values: `incidents`. Default: `incidents`.                                                                                                                                                                                       |
|                               | included                      | [<oneOf>] | Included related resources that the user requested. Read-only.                                                                                                                                                                                                        |
| included                      | <type=users>                  | object    | User object returned by the API.                                                                                                                                                                                                                                      |
| <type=users>                  | attributes                    | object    | Attributes of user object returned by the API.                                                                                                                                                                                                                        |
| attributes                    | email                         | string    | Email of the user.                                                                                                                                                                                                                                                    |
| attributes                    | handle                        | string    | Handle of the user.                                                                                                                                                                                                                                                   |
| attributes                    | icon                          | string    | URL of the user's icon.                                                                                                                                                                                                                                               |
| attributes                    | name                          | string    | Name of the user.                                                                                                                                                                                                                                                     |
| attributes                    | uuid                          | string    | UUID of the user.                                                                                                                                                                                                                                                     |
| <type=users>                  | id                            | string    | ID of the user.                                                                                                                                                                                                                                                       |
| <type=users>                  | type                          | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| included                      | <type=incident_types>         | object    | Incident type response data.                                                                                                                                                                                                                                          |
| <type=incident_types>         | attributes                    | object    | Incident type's attributes.                                                                                                                                                                                                                                           |
| attributes                    | configuration                 | object    | The incident-type-scoped behavior settings. All fields are optional on update. Any field omitted from a PATCH request keeps its current value. This object is read-only on the incident type resource itself and is only mutated through the update (PATCH) endpoint. |
| configuration                 | allow_incident_deletion       | boolean   | Whether incidents of this type can be deleted. Default: `false`.                                                                                                                                                                                                      |
| configuration                 | allow_workflows               | boolean   | Whether automation workflows can be triggered for incidents of this type. Default: `true`.                                                                                                                                                                            |
| configuration                 | create_message                | string    | An optional message shown to users when they declare an incident of this type.                                                                                                                                                                                        |
| configuration                 | editable_timestamps           | boolean   | Whether responders can edit incident timestamps for incidents of this type. Default: `false`.                                                                                                                                                                         |
| configuration                 | private_incidents             | boolean   | Whether responders can create private incidents of this type. This is an opt-in setting, distinct from `private_incidents_by_default`, which controls whether incidents are created private automatically. Default: `false`.                                          |
| configuration                 | private_incidents_by_default  | boolean   | Whether incidents of this type are created as private by default. Default: `false`.                                                                                                                                                                                   |
| configuration                 | slug_source                   | enum      | When set to `servicenow`, incidents will display the ServiceNow record ID instead of the public ID. If no ServiceNow integration exists, the public ID will be displayed. Allowed enum values: `default`, `servicenow`. Default: `default`.                           |
| configuration                 | test_incidents                | boolean   | Whether incidents of this type are treated as test incidents. Default: `true`.                                                                                                                                                                                        |
| attributes                    | createdAt                     | date-time | Timestamp when the incident type was created. Read-only.                                                                                                                                                                                                              |
| attributes                    | createdBy                     | string    | A unique identifier that represents the user that created the incident type. Read-only.                                                                                                                                                                               |
| attributes                    | description                   | string    | Text that describes the incident type.                                                                                                                                                                                                                                |
| attributes                    | is_default                    | boolean   | If true, this incident type will be used as the default incident type if a type is not specified during the creation of incident resources. Default: `false`.                                                                                                         |
| attributes                    | lastModifiedBy                | string    | A unique identifier that represents the user that last modified the incident type. Read-only.                                                                                                                                                                         |
| attributes                    | modifiedAt                    | date-time | Timestamp when the incident type was last modified. Read-only.                                                                                                                                                                                                        |
| attributes                    | name [*required*]             | string    | The name of the incident type.                                                                                                                                                                                                                                        |
| attributes                    | prefix                        | string    | The string that will be prepended to the incident title across the Datadog app. Read-only.                                                                                                                                                                            |
| <type=incident_types>         | id [*required*]               | string    | The incident type's ID.                                                                                                                                                                                                                                               |
| <type=incident_types>         | relationships                 | object    | The incident type's resource relationships.                                                                                                                                                                                                                           |
| relationships                 | created_by_user               | object    | Relationship to user.                                                                                                                                                                                                                                                 |
| created_by_user               | data [*required*]             | object    | Relationship to user object.                                                                                                                                                                                                                                          |
| data                          | id [*required*]               | string    | A unique identifier that represents the user.                                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| relationships                 | google_meet_configuration     | object    | A reference to a Google Meet Configuration resource.                                                                                                                                                                                                                  |
| google_meet_configuration     | data [*required*]             | object    | The Google Meet configuration relationship data object.                                                                                                                                                                                                               |
| data                          | id [*required*]               | string    | The unique identifier of the Google Meet configuration.                                                                                                                                                                                                               |
| data                          | type [*required*]             | string    | The type of the Google Meet configuration.                                                                                                                                                                                                                            |
| relationships                 | last_modified_by_user         | object    | Relationship to user.                                                                                                                                                                                                                                                 |
| last_modified_by_user         | data [*required*]             | object    | Relationship to user object.                                                                                                                                                                                                                                          |
| data                          | id [*required*]               | string    | A unique identifier that represents the user.                                                                                                                                                                                                                         |
| data                          | type [*required*]             | enum      | Users resource type. Allowed enum values: `users`. Default: `users`.                                                                                                                                                                                                  |
| relationships                 | microsoft_teams_configuration | object    | A reference to a Microsoft Teams Configuration resource.                                                                                                                                                                                                              |
| microsoft_teams_configuration | data [*required*]             | object    | The Microsoft Teams configuration relationship data object.                                                                                                                                                                                                           |
| data                          | id [*required*]               | string    | The unique identifier of the Microsoft Teams configuration.                                                                                                                                                                                                           |
| data                          | type [*required*]             | string    | The type of the Microsoft Teams configuration.                                                                                                                                                                                                                        |
| relationships                 | zoom_configuration            | object    | A reference to a Zoom configuration resource.                                                                                                                                                                                                                         |
| zoom_configuration            | data [*required*]             | object    | The Zoom configuration relationship data object.                                                                                                                                                                                                                      |
| data                          | id [*required*]               | string    | The unique identifier of the Zoom configuration.                                                                                                                                                                                                                      |
| data                          | type [*required*]             | string    | The type of the Zoom configuration.                                                                                                                                                                                                                                   |
| <type=incident_types>         | type [*required*]             | enum      | Incident type resource type. Allowed enum values: `incident_types`. Default: `incident_types`.                                                                                                                                                                        |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "attributes": {
      "archived": "2019-09-19T10:00:00.000Z",
      "case_id": "integer",
      "created": "2025-01-01T00:00:00Z",
      "created_by_uuid": "string",
      "creation_idempotency_key": "string",
      "customer_impact_end": "2019-09-19T10:00:00.000Z",
      "customer_impact_scope": "An example customer impact scope",
      "customer_impact_start": "2019-09-19T10:00:00.000Z",
      "declared": "2025-01-01T00:00:00Z",
      "declared_by_uuid": "string",
      "detected": "2025-01-01T00:00:00Z",
      "fields": {
        "<any-key>": "undefined"
      },
      "incident_type_uuid": "00000000-0000-0000-0000-000000000000",
      "is_test": false,
      "last_modified_by_uuid": "string",
      "modified": "2019-09-19T10:00:00.000Z",
      "non_datadog_creator": {
        "image_48_px": "string",
        "name": "string"
      },
      "notification_handles": [
        {
          "display_name": "Jane Doe",
          "handle": "@test.user@test.com"
        }
      ],
      "public_id": 1,
      "resolved": "2019-09-19T10:00:00.000Z",
      "severity": "UNKNOWN",
      "state": "string",
      "title": "A test incident title",
      "visibility": "string"
    },
    "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-0001-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": [
    {
      "attributes": {
        "email": "string",
        "handle": "string",
        "icon": "string",
        "name": "string",
        "uuid": "string"
      },
      "id": "string",
      "type": "users"
    }
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="400" %}
Bad Request

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="401" %}
Unauthorized

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="403" %}
Forbidden

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="404" %}
Not Found

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="429" %}
Too many requests

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}
{% /tabs %}

### Code Example

{% tabs %}
{% tab label="Curl" %}
```bash
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/incidents/import" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "incidents",
    "attributes": {
      "title": "Example-Incident",
      "visibility": "organization"
    }
  }
}
EOF
```
{% /tab %}

{% tab label="Go" %}
```go
// Import an incident returns "CREATED" response

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"os"

	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
)

func main() {
	body := datadogV2.IncidentImportRequest{
		Data: datadogV2.IncidentImportRequestData{
			Type: datadogV2.INCIDENTTYPE_INCIDENTS,
			Attributes: datadogV2.IncidentImportRequestAttributes{
				Title:      "Example-Incident",
				Visibility: datadogV2.INCIDENTIMPORTVISIBILITY_ORGANIZATION.Ptr(),
			},
		},
	}
	ctx := datadog.NewDefaultContext(context.Background())
	ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
	configuration := datadog.NewConfiguration()
	configuration.SetUnstableOperationEnabled("v2.ImportIncident", true)
	apiClient := datadog.NewAPIClient(configuration)
	api := datadogV2.NewIncidentsApi(apiClient)
	resp, r, err := api.ImportIncident(ctx, body, *datadogV2.NewImportIncidentOptionalParameters())

	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `IncidentsApi.ImportIncident`: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}

	responseContent, _ := json.MarshalIndent(resp, "", "  ")
	fmt.Fprintf(os.Stdout, "Response from `IncidentsApi.ImportIncident`:\n%s\n", responseContent)
}
```

#### Instructions

First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands:

```bash
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"
```
{% /tab %}

{% tab label="Java" %}
```java
// Import an incident returns "CREATED" response

import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.IncidentsApi;
import com.datadog.api.client.v2.model.IncidentImportRequest;
import com.datadog.api.client.v2.model.IncidentImportRequestAttributes;
import com.datadog.api.client.v2.model.IncidentImportRequestData;
import com.datadog.api.client.v2.model.IncidentImportResponse;
import com.datadog.api.client.v2.model.IncidentImportVisibility;
import com.datadog.api.client.v2.model.IncidentType;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = ApiClient.getDefaultApiClient();
    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
    defaultClient.setUnstableOperationEnabled("v2.importIncident", true);
    IncidentsApi apiInstance = new IncidentsApi(defaultClient);

    IncidentImportRequest body =
        new IncidentImportRequest()
            .data(
                new IncidentImportRequestData()
                    .type(IncidentType.INCIDENTS)
                    .attributes(
                        new IncidentImportRequestAttributes()
                            .title("Example-Incident")
                            .visibility(IncidentImportVisibility.ORGANIZATION)));

    try {
      IncidentImportResponse result = apiInstance.importIncident(body);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling IncidentsApi#importIncident");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}
```

#### Instructions

First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands:

```bash
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"
```
{% /tab %}

{% tab label="Python" %}
```python
"""
Import an incident returns "CREATED" response
"""

from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v2.api.incidents_api import IncidentsApi
from datadog_api_client.v2.model.incident_import_request import IncidentImportRequest
from datadog_api_client.v2.model.incident_import_request_attributes import IncidentImportRequestAttributes
from datadog_api_client.v2.model.incident_import_request_data import IncidentImportRequestData
from datadog_api_client.v2.model.incident_import_visibility import IncidentImportVisibility
from datadog_api_client.v2.model.incident_type import IncidentType

body = IncidentImportRequest(
    data=IncidentImportRequestData(
        type=IncidentType.INCIDENTS,
        attributes=IncidentImportRequestAttributes(
            title="Example-Incident",
            visibility=IncidentImportVisibility.ORGANIZATION,
        ),
    ),
)

configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
configuration.unstable_operations["import_incident"] = True
with ApiClient(configuration) as api_client:
    api_instance = IncidentsApi(api_client)
    response = api_instance.import_incident(body=body)

    print(response)
```

#### Instructions

First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands:

```bash
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"
```
{% /tab %}

{% tab label="Ruby" %}
```ruby
# Import an incident returns "CREATED" response

require "datadog_api_client"
DatadogAPIClient.configure do |config|
  config.access_token = ENV["DD_BEARER_TOKEN"]
  config.unstable_operations["v2.import_incident".to_sym] = true
end
api_instance = DatadogAPIClient::V2::IncidentsAPI.new

body = DatadogAPIClient::V2::IncidentImportRequest.new({
  data: DatadogAPIClient::V2::IncidentImportRequestData.new({
    type: DatadogAPIClient::V2::IncidentType::INCIDENTS,
    attributes: DatadogAPIClient::V2::IncidentImportRequestAttributes.new({
      title: "Example-Incident",
      visibility: DatadogAPIClient::V2::IncidentImportVisibility::ORGANIZATION,
    }),
  }),
})
p api_instance.import_incident(body)
```

#### Instructions

First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands:

```bash
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"
```
{% /tab %}

{% tab label="Rust" %}
```rust
// Import an incident returns "CREATED" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV2::api_incidents::ImportIncidentOptionalParams;
use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
use datadog_api_client::datadogV2::model::IncidentImportRequest;
use datadog_api_client::datadogV2::model::IncidentImportRequestAttributes;
use datadog_api_client::datadogV2::model::IncidentImportRequestData;
use datadog_api_client::datadogV2::model::IncidentImportVisibility;
use datadog_api_client::datadogV2::model::IncidentType;

#[tokio::main]
async fn main() {
    let body = IncidentImportRequest::new(IncidentImportRequestData::new(
        IncidentImportRequestAttributes::new("Example-Incident".to_string())
            .visibility(IncidentImportVisibility::ORGANIZATION),
        IncidentType::INCIDENTS,
    ));
    let mut configuration = datadog::Configuration::new();
    configuration.set_unstable_operation_enabled("v2.import_incident", true);
    let api = IncidentsAPI::with_config(configuration);
    let resp = api
        .import_incident(body, ImportIncidentOptionalParams::default())
        .await;
    if let Ok(value) = resp {
        println!("{:#?}", value);
    } else {
        println!("{:#?}", resp.unwrap_err());
    }
}
```

#### Instructions

First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands:

```bash
DD_SITE="datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo run
```
{% /tab %}

{% tab label="TypeScript" %}
```typescript
/**
 * Import an incident returns "CREATED" response
 */

import { client, v2 } from "@datadog/datadog-api-client";

const configuration = client.createConfiguration({
  authMethods: {
    AuthZ: {
      accessToken: process.env.DD_BEARER_TOKEN as string,
    },
  },
});
configuration.unstableOperations["v2.importIncident"] = true;
const apiInstance = new v2.IncidentsApi(configuration);

const params: v2.IncidentsApiImportIncidentRequest = {
  body: {
    data: {
      type: "incidents",
      attributes: {
        title: "Example-Incident",
        visibility: "organization",
      },
    },
  },
};

apiInstance
  .importIncident(params)
  .then((data: v2.IncidentImportResponse) => {
    console.log(
      "API called successfully. Returned data: " + JSON.stringify(data)
    );
  })
  .catch((error: any) => console.error(error));
```

#### Instructions

First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands:

```bash
DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" tsc "example.ts"
```
{% /tab %}
{% /tabs %}
