Incidents
Incidents
Incidents let you manage disruptions displayed on your status pages. Track each incident from initial investigation through resolution, post updates along the way, and keep your users informed — all through the API.
List incidents
/api/v1/incidents
Returns a paginated list of all incidents in the project associated with your API key.
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | — | Filter by status (investigating, identified, monitoring, or resolved) |
active_only | boolean | — | Set to true to return only unresolved incidents |
per_page | integer | 25 | Results per page |
page | integer | 1 | Page number |
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://watchcron.com/api/v1/incidents?active_only=true&per_page=10"
$response = Http::withToken('YOUR_API_KEY') ->get('https://watchcron.com/api/v1/incidents', [ 'active_only' => true, 'per_page' => 10, ]); $incidents = $response->json('data');
import requests response = requests.get( "https://watchcron.com/api/v1/incidents", headers={"Authorization": "Bearer YOUR_API_KEY"}, params={"active_only": "true", "per_page": 10}, ) incidents = response.json()["data"]
const response = await fetch( "https://watchcron.com/api/v1/incidents?active_only=true&per_page=10", { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); const { data: incidents } = await response.json();
req, _ := http.NewRequest("GET", "https://watchcron.com/api/v1/incidents?active_only=true&per_page=10", nil) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close()
Response 200 OK
{
"data": [
{
"uuid": "a7b8c9d0-e1f2-3456-abcd-567890123456",
"title": "Database connectivity issues",
"status": "investigating",
"severity": "major",
"resolved_at": null,
"updates": [
{
"id": 1,
"message": "We are investigating reports of failed database connections.",
"status": "investigating",
"created_at": "2026-10-26T14:05:00Z"
}
],
"created_at": "2026-10-26T14:05:00Z",
"updated_at": "2026-10-26T14:05:00Z"
}
],
"meta": {
"pagination": {
"total": 8,
"per_page": 10,
"current_page": 1,
"last_page": 1
}
}
}
Incident object
Every incident response includes these fields:
| Field | Type | Description |
|---|---|---|
uuid | string | Unique identifier (UUID v4). Used in all API URLs. |
title | string | Short summary of the incident |
status | string | Current status: investigating, identified, monitoring, or resolved |
severity | string | Impact level: minor, major, or critical |
resolved_at | string|null | ISO 8601 timestamp when the incident was resolved. Automatically set when status changes to resolved. |
updates | array | List of incident update entries (see below) |
created_at | string | ISO 8601 timestamp |
updated_at | string | ISO 8601 timestamp |
Update entry fields
| Field | Type | Description |
|---|---|---|
id | integer | Unique identifier for the update entry |
message | string | The update message text |
status | string | The incident status at the time this update was posted |
created_at | string | ISO 8601 timestamp |
Status values
| Status | Meaning |
|---|---|
investigating | The issue has been reported and the team is looking into it |
identified | The root cause has been found |
monitoring | A fix has been applied and the team is watching for recurrence |
resolved | The incident is fully resolved — resolved_at is set automatically |
Severity values
| Severity | Meaning |
|---|---|
minor | Limited impact — most users are unaffected |
major | Significant impact — core functionality is degraded |
critical | Full outage — the service is completely unavailable |
Create an incident
/api/v1/incidents
Request body
| Field | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Incident title (max 255 characters) |
status | string | No | investigating, identified, monitoring, or resolved (defaults to investigating) |
severity | string | No | minor, major, or critical (defaults to major) |
message | string | No | Initial update message (max 5000 characters). Creates the first incident update entry. |
message when creating an incident to automatically post the first update. This saves a separate API call and immediately gives your status page subscribers context about the issue.curl -X POST https://watchcron.com/api/v1/incidents \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Database connectivity issues", "severity": "major", "message": "We are investigating reports of failed database connections." }'
$response = Http::withToken('YOUR_API_KEY') ->post('https://watchcron.com/api/v1/incidents', [ 'title' => 'Database connectivity issues', 'severity' => 'major', 'message' => 'We are investigating reports of failed database connections.', ]); $incident = $response->json('data'); echo "Incident UUID: " . $incident['uuid'];
import requests response = requests.post( "https://watchcron.com/api/v1/incidents", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={ "title": "Database connectivity issues", "severity": "major", "message": "We are investigating reports of failed database connections.", }, ) incident = response.json()["data"] print(f"Incident UUID: {incident['uuid']}")
const response = await fetch("https://watchcron.com/api/v1/incidents", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ title: "Database connectivity issues", severity: "major", message: "We are investigating reports of failed database connections.", }), }); const { data: incident } = await response.json(); console.log(`Incident UUID: ${incident.uuid}`);
body := strings.NewReader(`{ "title": "Database connectivity issues", "severity": "major", "message": "We are investigating reports of failed database connections." }`) req, _ := http.NewRequest("POST", "https://watchcron.com/api/v1/incidents", body) req.Header.Set("Authorization", "Bearer YOUR_API_KEY") req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close()
Response 201 Created
{
"data": {
"uuid": "a7b8c9d0-e1f2-3456-abcd-567890123456",
"title": "Database connectivity issues",
"status": "investigating",
"severity": "major",
"resolved_at": null,
"updates": [
{
"id": 1,
"message": "We are investigating reports of failed database connections.",
"status": "investigating",
"created_at": "2026-10-26T14:05:00Z"
}
],
"created_at": "2026-10-26T14:05:00Z",
"updated_at": "2026-10-26T14:05:00Z"
}
}
Validation errors
If required fields are missing or values are invalid, the API returns 422:
{
"error": "The title field is required."
}
Get an incident
/api/v1/incidents/{uuid}
Returns full details for a single incident, including all update entries.
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://watchcron.com/api/v1/incidents/a7b8c9d0-e1f2-3456-abcd-567890123456"
$uuid = 'a7b8c9d0-e1f2-3456-abcd-567890123456'; $response = Http::withToken('YOUR_API_KEY') ->get("https://watchcron.com/api/v1/incidents/{$uuid}"); $incident = $response->json('data');
uuid = "a7b8c9d0-e1f2-3456-abcd-567890123456" response = requests.get( f"https://watchcron.com/api/v1/incidents/{uuid}", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) incident = response.json()["data"]
const uuid = "a7b8c9d0-e1f2-3456-abcd-567890123456"; const response = await fetch( `https://watchcron.com/api/v1/incidents/${uuid}`, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); const { data: incident } = await response.json();
Response 200 OK
{
"data": {
"uuid": "a7b8c9d0-e1f2-3456-abcd-567890123456",
"title": "Database connectivity issues",
"status": "identified",
"severity": "major",
"resolved_at": null,
"updates": [
{
"id": 1,
"message": "We are investigating reports of failed database connections.",
"status": "investigating",
"created_at": "2026-10-26T14:05:00Z"
},
{
"id": 2,
"message": "Root cause identified: connection pool exhaustion on the primary replica.",
"status": "identified",
"created_at": "2026-10-26T14:22:00Z"
}
],
"created_at": "2026-10-26T14:05:00Z",
"updated_at": "2026-10-26T14:22:00Z"
}
}
Returns 404 if the UUID does not exist or belongs to a different project.
Update an incident
/api/v1/incidents/{uuid}
Updates one or more fields on an existing incident. Only include the fields you want to change — all fields are optional. Include a message to post a new update entry.
Request body
| Field | Type | Description |
|---|---|---|
title | string | Incident title (max 255 characters) |
status | string | investigating, identified, monitoring, or resolved |
severity | string | minor, major, or critical |
message | string | New update message (max 5000 characters). Creates a new incident update entry. |
status to resolved and the resolved_at timestamp is automatically recorded. Include a message to post a final resolution update at the same time.Example: resolve with a final update
curl -X PUT https://watchcron.com/api/v1/incidents/a7b8c9d0-e1f2-3456-abcd-567890123456 \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "resolved", "message": "Connection pool limits increased. All services restored." }'
$response = Http::withToken('YOUR_API_KEY') ->put("https://watchcron.com/api/v1/incidents/{$uuid}", [ 'status' => 'resolved', 'message' => 'Connection pool limits increased. All services restored.', ]);
response = requests.put( f"https://watchcron.com/api/v1/incidents/{uuid}", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={ "status": "resolved", "message": "Connection pool limits increased. All services restored.", }, )
const response = await fetch(`https://watchcron.com/api/v1/incidents/${uuid}`, { method: "PUT", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ status: "resolved", message: "Connection pool limits increased. All services restored.", }), });
Response 200 OK
{
"data": {
"uuid": "a7b8c9d0-e1f2-3456-abcd-567890123456",
"title": "Database connectivity issues",
"status": "resolved",
"severity": "major",
"resolved_at": "2026-10-26T15:10:00Z",
"updates": [
{
"id": 1,
"message": "We are investigating reports of failed database connections.",
"status": "investigating",
"created_at": "2026-10-26T14:05:00Z"
},
{
"id": 2,
"message": "Root cause identified: connection pool exhaustion on the primary replica.",
"status": "identified",
"created_at": "2026-10-26T14:22:00Z"
},
{
"id": 3,
"message": "Connection pool limits increased. All services restored.",
"status": "resolved",
"created_at": "2026-10-26T15:10:00Z"
}
],
"created_at": "2026-10-26T14:05:00Z",
"updated_at": "2026-10-26T15:10:00Z"
}
}
Delete an incident
/api/v1/incidents/{uuid}
Permanently deletes an incident and all its associated update entries.
curl -X DELETE \ -H "Authorization: Bearer YOUR_API_KEY" \ "https://watchcron.com/api/v1/incidents/a7b8c9d0-e1f2-3456-abcd-567890123456"
$response = Http::withToken('YOUR_API_KEY') ->delete("https://watchcron.com/api/v1/incidents/{$uuid}");
response = requests.delete( f"https://watchcron.com/api/v1/incidents/{uuid}", headers={"Authorization": "Bearer YOUR_API_KEY"}, )
const response = await fetch( `https://watchcron.com/api/v1/incidents/${uuid}`, { method: "DELETE", headers: { "Authorization": "Bearer YOUR_API_KEY" }, } );
Returns 204 No Content on success. This action is irreversible.