StatusDashboard
Severities

Get severity levels

Retrieve the severity levels configured for the organization.

View Markdown

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

FieldTypeDescription
severitiesarrayOrdered array of severity level objects (sorted by order ascending).
severities[].labelstringDisplay name of the severity level. Max 50 characters.
severities[].descriptionstringHuman-readable description. Max 150 characters.
severities[].iconstringApproved Lucide icon key (e.g. alert-triangle).
severities[].defaultColorstringHex color used for display on the status dashboard.
severities[].ordernumber1-based display order, unique and contiguous from 1 through the severity count.
limits.severityLevelsnumberOrganization limit for max severity levels.

Error responses

StatusWhen
403Insufficient permissions.

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.