---
title: 인시던트에서 페이지 생성
description: Cases 서비스를 사용하여 인시던트로부터 페이지를 생성합니다.
breadcrumbs: 문서 > API > 인시던트에서 페이지 생성
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt).

# 인시던트에서 페이지 생성

## v2 (deprecated)

{% alert level="warning" %}
**Note**: This endpoint is in preview and is subject to change.
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/{incident_id}/cases/page     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/incidents/{incident_id}/cases/page |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/incidents/{incident_id}/cases/page |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/incidents/{incident_id}/cases/page      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/incidents/{incident_id}/cases/page |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/incidents/{incident_id}/cases/page |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/incidents/{incident_id}/cases/page |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/incidents/{incident_id}/cases/page      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/incidents/{incident_id}/cases/page  |

### Overview

Cases 서비스를 사용하여 인시던트로부터 페이지를 생성합니다.

This endpoint requires all of the following permissions:

- `oncall_page`
- `incident_write`

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

### Arguments

#### Path Parameters

| Field                    | Type   | Description               |
| ------------------------ | ------ | ------------------------- |
| incident_id [*required*] | string | The UUID of the incident. |

### Request

#### Body Data (required)

페이지 생성 페이로드입니다.

{% tabs %}
{% tab label="Model" %}
| Parent field | Field                   | Type     | Description                                                                                                          |
| ------------ | ----------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
|              | data [*required*]       | object   | 인시던트에서 페이지를 생성하기 위한 요청 페이로드입니다.                                                                                      |
| data         | attributes [*required*] | object   | Attributes for creating a page from an incident.                                                                     |
| attributes   | description             | string   | The description of the page.                                                                                         |
| attributes   | incident_public_id      | string   | The public ID of the incident.                                                                                       |
| attributes   | role                    | object   | A reference to an incident role for a page.                                                                          |
| role         | id [*required*]         | uuid     | The role identifier.                                                                                                 |
| role         | type [*required*]       | enum     | The type of incident role for a page. Allowed enum values: `incident_user_defined_roles`, `incident_reserved_roles`. |
| attributes   | services                | [string] | List of affected services.                                                                                           |
| attributes   | tags                    | [string] | List of tags for the page.                                                                                           |
| attributes   | target                  | object   | The target recipient for a page.                                                                                     |
| target       | identifier [*required*] | string   | The identifier of the target (handle, UUID, or user UUID).                                                           |
| target       | type [*required*]       | enum     | The type of target for a page request. Allowed enum values: `team_handle`, `team_uuid`, `user_uuid`.                 |
| attributes   | title                   | string   | The title of the page.                                                                                               |
| data         | type [*required*]       | enum     | Resource type for a page creation request. Allowed enum values: `page`.                                              |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "attributes": {
      "description": "A critical incident affecting production systems.",
      "incident_public_id": "12345",
      "role": {
        "id": "00000000-0000-0000-0000-000000000000",
        "type": "incident_user_defined_roles"
      },
      "services": [
        "web-store",
        "checkout"
      ],
      "tags": [
        "env:prod"
      ],
      "target": {
        "identifier": "my-team-handle",
        "type": "team_uuid"
      },
      "title": "Production outage - SEV-1"
    },
    "type": "page"
  }
}
```
{% /tab %}
{% /tabs %}

### Response

{% tabs %}
{% tab label="200" %}
OK

{% tabs %}
{% tab label="Model" %}
Response with a page UUID.

| Parent field | Field             | Type   | Description                                                               |
| ------------ | ----------------- | ------ | ------------------------------------------------------------------------- |
|              | data [*required*] | object | Page UUID data in a response.                                             |
| data         | id [*required*]   | uuid   | The UUID of the created page.                                             |
| data         | type [*required*] | enum   | Resource type for a page UUID response. Allowed enum values: `page_uuid`. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000001",
    "type": "page_uuid"
  }
}
```
{% /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
# Path parameters
export incident_id="CHANGE_ME"

# 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/${incident_id}/cases/page" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "description": "A critical incident affecting production systems.",
      "services": [
        "web-store"
      ],
      "tags": [
        "env:prod"
      ],
      "target": {
        "identifier": "my-oncall-team",
        "type": "team_handle"
      },
      "title": "Production outage - SEV-1"
    },
    "type": "page"
  }
}
EOF
```
{% /tab %}
{% /tabs %}