−50%

50% off your first month on any paid plan · code WELCOME50 · until Nov 30

Start free →

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

GET /api/v1/incidents

Returns a paginated list of all incidents in the project associated with your API key.

Query parameters

ParameterTypeDefaultDescription
statusstring—Filter by status (investigating, identified, monitoring, or resolved)
active_onlyboolean—Set to true to return only unresolved incidents
per_pageinteger25Results per page
pageinteger1Page 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

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

FieldTypeDescription
uuidstringUnique identifier (UUID v4). Used in all API URLs.
titlestringShort summary of the incident
statusstringCurrent status: investigating, identified, monitoring, or resolved
severitystringImpact level: minor, major, or critical
resolved_atstring|nullISO 8601 timestamp when the incident was resolved. Automatically set when status changes to resolved.
updatesarrayList of incident update entries (see below)
created_atstringISO 8601 timestamp
updated_atstringISO 8601 timestamp

Update entry fields

FieldTypeDescription
idintegerUnique identifier for the update entry
messagestringThe update message text
statusstringThe incident status at the time this update was posted
created_atstringISO 8601 timestamp

Status values

StatusMeaning
investigatingThe issue has been reported and the team is looking into it
identifiedThe root cause has been found
monitoringA fix has been applied and the team is watching for recurrence
resolvedThe incident is fully resolved — resolved_at is set automatically

Severity values

SeverityMeaning
minorLimited impact — most users are unaffected
majorSignificant impact — core functionality is degraded
criticalFull outage — the service is completely unavailable

Create an incident

POST /api/v1/incidents

Request body

FieldTypeRequiredDescription
titlestringYesIncident title (max 255 characters)
statusstringNoinvestigating, identified, monitoring, or resolved (defaults to investigating)
severitystringNominor, major, or critical (defaults to major)
messagestringNoInitial update message (max 5000 characters). Creates the first incident update entry.
Tip: Include a 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

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

422 response
{
  "error": "The title field is required."
}

Get an incident

GET /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

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

PUT /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

FieldTypeDescription
titlestringIncident title (max 255 characters)
statusstringinvestigating, identified, monitoring, or resolved
severitystringminor, major, or critical
messagestringNew update message (max 5000 characters). Creates a new incident update entry.
Resolving an incident: Set 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

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

DELETE /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.

Pricing Docs
Log in Start free →