We’ve added a new endpoint to the StatusGator API that allows you to submit outage reports for monitors on your board.
With the new Outage Reports API, you can programmatically report issues you’re experiencing with a service. These reports help StatusGator detect outages faster and improve visibility for other users who rely on the same services.
What’s new
You can now create outage reports via the API:
POST /api/v3/boards/{board_id}/outage_reports
This endpoint allows your systems to report issues tied to a specific monitor on your board.
Why this matters
StatusGator helps teams detect outages earlier by combining official status updates with reports from real users experiencing issues.
If your monitoring system detects a problem before the service’s official status page reports it, you can submit an outage report through the API. These reports contribute to StatusGator’s Early Warning Signals system.
As a reminder, Early Warning Signals help identify potential outages before they’re officially confirmed. When enough users report issues with the same service within a short period of time, StatusGator recognizes the pattern and updates dashboards across the platform to indicate that an outage may be developing.
The more reports StatusGator receives, the earlier these signals can appear – helping teams respond faster when services they depend on start having problems.
Example request
curl https://statusgator.com/api/v3/boards/{board_id}/outage_reports \
--request POST \
--header "Content-Type: application/json" \
--header "Authorization: Bearer YOUR_SECRET_TOKEN" \
--data '{
"outage_report": {
"monitor_id": "abc123def",
"comment": "API returning 500s",
"email": "reporter@example.com",
"component_ids": [
"comp1",
"comp2"
]
}
}'Example request
{
"success": true,
"data": {
"id": "abc123def",
"monitor_id": "xyz789ghi",
"service_name": "GitHub",
"comment": "API returning 500s",
"email": "reporter@example.com",
"component_ids": ["comp1", "comp2"],
"confirmed_at": "2023-10-01T12:00:00Z",
"created_at": "2023-10-01T12:00:00Z"
}
}Get started
You can explore the new endpoint and request schema in the API documentation.
If you’re already using the API, this endpoint should integrate easily into your existing automation and incident workflows.
