Guide
Incidents
Powers a public platform status page — outages, degradations, and their resolution. Every endpoint on this page lives under https://api.swiftgoma.com/api/v1/incidents.
Public feed
GET / lists incidents most-recent-first, no authentication required.
Severity and status
| Severity | Status |
|---|---|
| MINOR | INVESTIGATING |
| MAJOR | IDENTIFIED |
| CRITICAL | MONITORING |
| — | RESOLVED |
Staff management
ADMIN and SUPPORT can open a new incident (title up to 200 characters, description up to 5000), update its description or severity, and update its status. Creating an incident, or changing its status, broadcasts a SYSTEM notification.
Two endpoints touch status: the general update endpoint accepts it as one of several fields, but the dedicated
PATCH /:id/status endpoint is the one that triggers the notification — prefer it when status is the only thing changing.Moving status to RESOLVED stamps a resolvedAt timestamp; moving it back off RESOLVED clears that timestamp.