Create an incident

Creates a new incident on a custom service. Only works with services you created in IsDown — not third-party services.

POST 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

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

{
  "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