POST/v2/outages

Create a manual incident

Creates a manual incident that can trigger escalation policies.

Request

Bodyapplication/json

descriptionstringrequired

Description of the incident

Example:"Database maintenance in progress"

escalationPolicyUuidstringoptional

UUID of the escalation policy to link to this incident. If provided, the policy will be triggered according to its step timing.

Example:"policy_xyz"

💡Manual vs Monitor Outages

Manual incidents must be resolved via the API or dashboard. Monitor-based outages are automatically resolved when the monitor recovers.

Response

Returns the created outage details.

RequestcURL

curl -X POST https://api.hyperping.io/v2/outages \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Database maintenance in progress",
    "escalationPolicyUuid": "policy_xyz"
  }'

200 OKJSON

{
  "message": "Incident created",
  "outage": {
    "uuid": "outage_abc123",
    "startDate": "2026-01-21T10:30:00.000Z",
    "description": "Database maintenance in progress",
    "escalationPolicyUuid": "policy_xyz"
  }
}

← Get an outage Acknowledge outage →