Creates an alert group

curl --request POST \ --url https://api.rootly.com/v1/alert_groups \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/vnd.api+json' \ --data ' { "data": { "type": "alert_groups", "attributes": { "name": "<string>", "description": "<string>", "time_window": 123, "targets": [ { "target_type": "Group", "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" } ], "attributes": [ { "json_path": "<string>" } ], "group_by_alert_title": 1, "group_by_alert_urgency": 1, "condition_type": "all", "conditions": [ { "property_field_type": "attribute", "property_field_condition_type": "is_one_of", "property_field_name": "<string>", "property_field_value": "<string>", "property_field_values": [ "<string>" ], "alert_urgency_ids": [ "<string>" ], "conditionable_type": "AlertField", "conditionable_id": "<string>" } ] } } } '

{ "data": { "id": "196d8b65-f176-40e1-af88-5d18f6360feb", "type": "alert_groups", "attributes": { "name": "Test alert group", "slug": "test-alert-group", "description": null, "time_window": 10, "condition_type": "any", "deleted_at": null, "created_at": "2025-12-04T21:49:18.587-08:00", "updated_at": "2025-12-04T21:49:18.587-08:00", "group_by_alert_title": false, "group_by_alert_urgency": false, "targets": [ { "id": "8bbaae27-8150-415c-bd9e-cc03e1f1c54d", "alert_group_id": "196d8b65-f176-40e1-af88-5d18f6360feb", "created_at": "2025-12-04T21:49:18.588-08:00", "deleted_at": null, "target_id": "4e984413-08b1-4dce-8646-29dc64f0b5d1", "target_type": "Service", "updated_at": "2025-12-04T21:49:18.588-08:00" } ], "attributes": [], "conditions": [ { "id": "6cdb2408-1157-4ffa-a4f7-ca95c78ba090", "property_field_condition_type": "is_one_of", "property_field_name": "description", "property_field_type": "attribute", "property_field_value": null, "property_field_values": [ "Test description" ], "created_at": "2025-12-04T21:49:18.589-08:00", "updated_at": "2025-12-04T21:49:18.589-08:00", "conditionable_type": null, "conditionable_id": null }, { "id": "70d09a59-3999-4e06-8451-13a1c053b3ab", "property_field_condition_type": "is_one_of", "property_field_name": "alert_urgency", "property_field_type": "attribute", "property_field_value": null, "property_field_values": [], "created_at": "2025-12-04T21:49:18.590-08:00", "updated_at": "2025-12-04T21:49:18.590-08:00", "conditionable_type": null, "conditionable_id": null, "values": [ { "record_id": "7219c0a2-6ac4-46fe-8015-1ec1c98d6c08", "record_type": "AlertUrgency" } ] } ] } } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/vnd.api+json

data

object

required

Show child attributes

data.type

enum<string>

required

Available options:

alert_groups

data.attributes

object

required

Show child attributes

data.attributes.name

string

required

The name of the alert group

data.attributes.description

string | null

The description of the alert urgency

data.attributes.time_window

integer

The length of time an Alert Group should stay open and accept new alerts

data.attributes.targets

object[]

Show child attributes

data.attributes.targets.target_type

enum<string>

required

The type of the target.

Available options:

Group,

Service,

EscalationPolicy

data.attributes.targets.target_id

string<uuid>

required

id for the Group, Service or EscalationPolicy

data.attributes.attributes

object[]

deprecated

This field is deprecated. Please use the conditions field instead, attributes will be removed in the future.

Show child attributes

data.attributes.attributes.json_path

string

The JSON path to the value to group by.

data.attributes.group_by_alert_title

enum<integer>

Whether the alerts should be grouped by titles.

Available options:

1,

0

data.attributes.group_by_alert_urgency

enum<integer>

Whether the alerts should be grouped by urgencies.

Available options:

1,

0

data.attributes.condition_type

enum<string>

Group alerts when ANY or ALL of the fields are matching.

Available options:

all,

any

data.attributes.conditions

object[]

Show child attributes

data.attributes.conditions.property_field_type

enum<string>

required

The type of the property field

Available options:

attribute,

payload,

alert_field

data.attributes.conditions.property_field_condition_type

enum<string>

required

The condition type of the property field

Available options:

is_one_of,

is_not_one_of,

contains,

does_not_contain,

starts_with,

ends_with,

matches_regex,

is_empty,

matches_existing_alert

data.attributes.conditions.property_field_name

string

The name of the property field. If the property field type is selected as 'attribute', then the allowed property field names are 'summary' (for Title), 'description', 'alert_urgency' and 'external_url' (for Alert Source URL). If the property field type is selected as 'payload', then the property field name should be supplied in JSON Path syntax.

data.attributes.conditions.property_field_value

string

The value of the property field. Can be null if the property field condition type is 'is_one_of' or 'is_not_one_of'

data.attributes.conditions.property_field_values

string[]

The values of the property field. Need to be passed if the property field condition type is 'is_one_of' or 'is_not_one_of' except for when property field name is 'alert_urgency'

data.attributes.conditions.alert_urgency_ids

string[] | null

The Alert Urgency ID's to check in the condition. Only need to be set when the property field type is 'attribute', the property field name is 'alert_urgency' and the property field condition type is 'is_one_of' or 'is_not_one_of'

data.attributes.conditions.conditionable_type

enum<string>

The type of the conditionable

Available options:

AlertField

data.attributes.conditions.conditionable_id

string

The ID of the conditionable. If conditionable_type is AlertField, this is the ID of the alert field.

Response

alert group created with conditions

data

object

required

Show child attributes

data.id

string

required

Unique ID of the alert group

data.type

enum<string>

required

Available options:

alert_groups

data.attributes

object

required

Show child attributes

data.attributes.name

string

required

The name of the alert group

data.attributes.description

string | null

required

The description of the alert group

data.attributes.slug

string

required

The slug of the alert group

data.attributes.condition_type

string

required

Grouping condition for the alert group

data.attributes.time_window

integer

required

Time window for the alert grouping

data.attributes.created_at

string

required

Date of creation

data.attributes.updated_at

string

required

Date of last update

data.attributes.deleted_at

string | null

required

Date or deletion

data.attributes.group_by_alert_title

boolean

Whether the alerts are grouped by title or not

data.attributes.group_by_alert_urgency

boolean

Whether the alerts are grouped by urgency or not

data.attributes.targets

object[]

Show child attributes

data.attributes.targets.target_type

enum<string>

required

The type of the target.

Available options:

Group,

Service,

EscalationPolicy

data.attributes.targets.target_id

string<uuid>

required

id for the Group, Service or EscalationPolicy

data.attributes.attributes

object[]

deprecated

This field is deprecated. Please use the conditions field instead, attributes will be removed in the future.

Show child attributes

data.attributes.attributes.json_path

string

The JSON path to the value to group by.

data.attributes.conditions

object[]

The conditions for the alert group

Show child attributes

data.attributes.conditions.property_field_type

enum<string>

required

The type of the property field

Available options:

attribute,

payload,

alert_field

data.attributes.conditions.property_field_condition_type

enum<string>

required

The condition type of the property field

Available options:

is_one_of,

is_not_one_of,

contains,

does_not_contain,

starts_with,

ends_with,

matches_regex,

is_empty,

matches_existing_alert

data.attributes.conditions.property_field_name

string | null

data.attributes.conditions.property_field_value

string | null

The value of the property field. Can be null if the property field condition type is 'is_one_of' or 'is_not_one_of'

data.attributes.conditions.property_field_values

string[]

The values of the property field. Used if the property field condition type is 'is_one_of' or 'is_not_one_of' except for when property field name is 'alert_urgency'

data.attributes.conditions.values

(object | null)[]

Show child attributes

data.attributes.conditions.values.record_id

string

required

ID of the Alert Urgency to set.

data.attributes.conditions.values.record_type

string

required

Should be "AlertUrgency".

data.attributes.conditions.alert_urgency_ids

string[] | null

data.attributes.conditions.conditionable_type

enum<string> | null

The type of the conditionable

Available options:

AlertField

data.attributes.conditions.conditionable_id

string | null

The ID of the conditionable. If conditionable_type is AlertField, this is the ID of the alert field.

Overview

AlertEvents

AlertFields

AlertGroups

AlertRoutes

AlertRoutingRules

AlertUrgencies

AlertSources

Alerts

Audits

Authorizations

CatalogEntities

CatalogEntityProperties

CatalogFields

Catalogs

Causes

Communications Groups

Communications Stages

Communications Templates

Communications Types

[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