Severities
Get severity levels
Retrieve the severity levels configured for the organization.
GET /app/severities
Returns the tenant's custom severity level configuration.
Request
See API Basics for required headers.
This endpoint takes no request body or query parameters.
Sample request
curl https://api.statusdashboard.com/app/severities \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 200 OK
{
"severities": [
{
"label": "Degraded Performance",
"description": "Minor service issues, some users may see slow performance.",
"icon": "alert-triangle",
"defaultColor": "#CA8A04",
"order": 1
},
{
"label": "Partial Outage",
"description": "A major feature or part of the service is unavailable.",
"icon": "alert-circle",
"defaultColor": "#EA580C",
"order": 2
},
{
"label": "Major Outage",
"description": "A critical service is completely down or all users are affected.",
"icon": "alert-octagon",
"defaultColor": "#991B1B",
"order": 3
}
],
"limits": {
"severityLevels": 6
}
}Response fields
| Field | Type | Description |
|---|---|---|
severities | array | Ordered array of severity level objects (sorted by order ascending). |
severities[].label | string | Display name of the severity level. Max 50 characters. |
severities[].description | string | Human-readable description. Max 150 characters. |
severities[].icon | string | Approved Lucide icon key (e.g. alert-triangle). |
severities[].defaultColor | string | Hex color used for display on the status dashboard. |
severities[].order | number | 1-based display order, unique and contiguous from 1 through the severity count. |
limits.severityLevels | number | Organization limit for max severity levels. |
Error responses
| Status | When |
|---|---|
403 | Insufficient permissions. |

