Overview
Reference
- AlertEvents
- AlertGroups
- AlertUrgencies
- AlertSources
- Alerts
- Audits
- Authorizations
- CatalogEntities
- CatalogEntityProperties
- CatalogFields
- Catalogs
- Causes
- [DEPRECATED] CustomFieldOptions
- [DEPRECATED] CustomFields
- CustomForms
- DashboardPanels
- Dashboards
- Environments
- EscalationPolicies
- EscalationLevelsPolicies
- EscalationLevelsPath
- EscalationLevels
- EscalationPaths
- FormFieldOptions
- FormFieldPlacementConditions
- FormFieldPlacements
- FormFieldPositions
- FormFields
- FormSetConditions
- FormSets
- Functionalities
- WorkflowTasks
- [DEPRECATED] WorkflowCustomFieldSelections
- WorkflowFormFieldConditions
- WorkflowGroups
- WorkflowRuns
- Workflows
- Heartbeats
- IncidentActionItems
- [DEPRECATED] IncidentCustomFieldSelections
- IncidentEventFunctionalities
- IncidentEventServices
- IncidentEvents
- IncidentFeedbacks
- IncidentFormFieldSelections
- IncidentPermissionSetBooleans
- IncidentPermissionSetResources
- IncidentPermissionSets
- IncidentRetrospectives
- IncidentRetrospectiveSteps
- IncidentRoleTasks
- IncidentRoles
- IncidentStatusPageEvents
- IncidentSubStatuses
- IncidentTypes
- Incidents
- IpRanges
- LiveCallRouters
- OnCallRoles
- OnCallShadows
- OverrideShifts
- PlaybookTasks
- Playbooks
- RetrospectiveTemplates
- Pulses
- RetrospectiveConfigurations
- RetrospectiveProcessGroupSteps
- RetrospectiveProcessGroups
- RetrospectiveProcesses
- RetrospectiveSteps
- Roles
- ScheduleRotationActiveDays
- ScheduleRotationUsers
- ScheduleRotations
- Schedules
- Shifts
- Secrets
- Services
- Severities
- StatusPageTemplates
- StatusPages
- SubStatuses
- Teams
- UserNotificationRules
- Users
- WebhooksDeliveries
- WebhooksEndpoints
Creates an alert group
Creates a new alert group
curl --request POST \
--url https://api.rootly.com/v1/alert_groups \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "ed26baf9-4844-4fb9-9e13-994dd531b2f9",
"type": "alert_groups",
"attributes": {
"name": "Test alert group",
"slug": "test-alert-group",
"description": null,
"time_window": 10,
"condition_type": "any",
"group_by_alert_title": false,
"group_by_alert_urgency": false,
"deleted_at": null,
"created_at": "2025-03-13T11:58:34.260-07:00",
"updated_at": "2025-03-13T11:58:34.260-07:00",
"targets": [
{
"id": "a31e687b-7fdd-4da3-bef7-9ed4b9f536c7",
"target_type": "Service",
"target_id": "c28070cb-47d0-402e-8f43-9de265917a91",
"alert_group_id": "ed26baf9-4844-4fb9-9e13-994dd531b2f9",
"deleted_at": null,
"created_at": "2025-03-13T11:58:34.261-07:00",
"updated_at": "2025-03-13T11:58:34.261-07:00"
}
],
"attributes": []
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
alert_groups
The name of the alert group
The description of the alert urgency
The length of time an Alert Group should stay open and accept new alerts
The JSON path to the value to group by.
Whether the alerts should be grouped by titles.
1
, 0
Whether the alerts should be grouped by urgencies.
1
, 0
Group alerts when ANY or ALL of the fields are matching.
all
, any
Response
Unique ID of the alert group
alert_groups
The name of the alert group
The description of the alert group
The slug of the alert group
Grouping condition for the alert group
Time window for the alert grouping
Whether the alerts are grouped by title or not
Whether the alerts are grouped by urgency or not
Date of creation
Date of last update
Date or deletion
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/alert_groups \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'
{
"data": {
"id": "ed26baf9-4844-4fb9-9e13-994dd531b2f9",
"type": "alert_groups",
"attributes": {
"name": "Test alert group",
"slug": "test-alert-group",
"description": null,
"time_window": 10,
"condition_type": "any",
"group_by_alert_title": false,
"group_by_alert_urgency": false,
"deleted_at": null,
"created_at": "2025-03-13T11:58:34.260-07:00",
"updated_at": "2025-03-13T11:58:34.260-07:00",
"targets": [
{
"id": "a31e687b-7fdd-4da3-bef7-9ed4b9f536c7",
"target_type": "Service",
"target_id": "c28070cb-47d0-402e-8f43-9de265917a91",
"alert_group_id": "ed26baf9-4844-4fb9-9e13-994dd531b2f9",
"deleted_at": null,
"created_at": "2025-03-13T11:58:34.261-07:00",
"updated_at": "2025-03-13T11:58:34.261-07:00"
}
],
"attributes": []
}
}
}