Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
        1. List severities GET
        2. Get severity GET
        3. Create severity POST
        4. Update severity PATCH
        5. Remove severity DELETE
      7. Severity groups
      8. Incidents
      9. Comments
    6. Status pages
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Update severity

Update an existing severity.

PATCH https://incidents.betterstack.com/api/v2/urgencies/{urgency_id}

URL parameters

urgency_id
required integer

The ID of the severity you want to update

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

name
required string

The name of this severity.

sms
required boolean

Whether to send SMS when a new incident is created.

call
required boolean

Whether to call when a new incident is created.

email
required boolean

Whether to send e-mail when a new incident is created.

push
required boolean

Whether to send push notification when a new incident is created.

critical_alert
boolean

Whether to send a critical push notification that ignores the mute switch and Do Not Disturb mode. Defaults to false.

urgency_group_id
integer

The ID of the severity group to move this severity to, or null to remove it from its group.

200

Returns the updated severity. Each team member can override the severity's alert channels for themselves in their Alerts settings.

Response body

{
  "data": {
    "id": "456",
    "type": "urgency",
    "attributes": {
      "name": "Edited severity",
      "team_name": "Test team",
      "sms": false,
      "call": true,
      "email": false,
      "push": true,
      "critical_alert": false,
      "urgency_group_id": null
    }
  }
}

Example cURL

Example
curl -X "PATCH" "https://incidents.betterstack.com/api/v2/urgencies/456" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{ "name": "Edited severity", "sms": false, "call": true, "email": false, "push": true }'


Previous article

Create severity

Next article

Remove severity