# Create an incident

<mark style="color:blue;">`POST`</mark> `https://isdown.app/api/v2/incidents`

### Request body

| Parameter          | Type    | Required | Description                                                                             |
| ------------------ | ------- | -------- | --------------------------------------------------------------------------------------- |
| `service_id`       | integer | Yes      | The numeric ID of the custom service                                                    |
| `title`            | string  | Yes      | Short title describing the incident                                                     |
| `status`           | string  | No       | `minor` or `major`. Defaults to `minor`                                                 |
| `description`      | string  | No       | Initial update message. Defaults to empty string                                        |
| `resolution_stage` | string  | No       | `investigating`, `identified`, `monitoring`, or `resolved`. Defaults to `investigating` |

### Example request

```bash
curl -X POST https://api.isdown.app/api/v2/incidents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 1234,
    "title": "API response times elevated",
    "status": "minor",
    "description": "We are seeing elevated response times on our API.",
    "resolution_stage": "investigating"
  }'
```

### Example Response

```bash
{
  "data": {
    "id": "55001",
    "type": "incidents",
    "attributes": {
      "url": null,
      "title": "API response times elevated",
      "description": "We are seeing elevated response times on our API.",
      "status": "minor",
      "resolved": false,
      "created_at": "2024-03-15T10:00:00.000Z",
      "resolved_at": null,
      "updated_at": "2024-03-15T10:00:00.000Z",
      "service_id": 1234,
      "service": "My API",
      "service_status_url": null,
      "service_urlname": "my-api",
      "user_generated": false,
      "severity_from_provider": null,
      "components": [],
      "updates": [
        {
          "status": "investigating",
          "created_at": "2024-03-15T10:00:00.000Z",
          "description": "We are seeing elevated response times on our API."
        }
      ],
      "isdown_url": null
    }
  }
}
```

#### Notes

* Creating an incident automatically updates the service status on any linked status pages
* Subscribers to your status page will be notified according to your notification settings
* Setting resolution\_stage to resolved immediately marks the incident as resolved