POST/ incidents

Create a new incident to track issues, outages, or events affecting your services.

Authentication

This endpoint requires authentication. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can generate API keys in your dashboard settings

Request Body

{
  "title": "Database connection timeout",
  "severity": "high",
  "status": "investigating",
  "description": "Users experiencing slow response times",
  "affected_services": [
    "api",
    "database"
  ],
  "assigned_to": "team-backend"
}

Parameters

Field	Type	Required	Description
title	string	Yes	Brief description of the incident
severity	enum	Yes	low, medium, high, critical
status	enum	No	investigating, identified, monitoring, resolved
description	string	No	Detailed description of the incident
affected_services	array	No	List of affected service identifiers

Response

Example Response – 201 Created

{
  "id": "inc_1234567890",
  "title": "Database connection timeout",
  "severity": "high",
  "status": "investigating",
  "description": "Users experiencing slow response times",
  "affected_services": [
    "api",
    "database"
  ],
  "assigned_to": "team-backend",
  "created_at": "2026-01-29T10:30:00Z",
  "updated_at": "2026-01-29T10:30:00Z",
  "url": "https://api.saferwatch.com/incidents/inc_1234567890"
}

Returns the created incident object with additional metadata including unique ID and timestamps.

Error Codes

Status Code	Error	Description
400	Bad Request	Invalid request parameters
401	Unauthorized	Missing or invalid API key
403	Forbidden	Insufficient permissions
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Something went wrong on our end

Ready to get started ?

Try our API in a sandbox environment with test data. No signup required.