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
Update an alert source
Update a specific alert source by id
curl --request PUT \
--url https://api.rootly.com/v1/alert_sources/%7Bid%7D \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'{
"data": {
"id": "a60d30b7-8fa1-4184-8016-07711554681c",
"type": "alert_sources",
"attributes": {
"name": "GW 2",
"source_type": "datadog",
"status": "setup_incomplete",
"secret": "5d68889f8423f0f6f74840231e3916503851ab676a38dbf1b529caffe95ebe69",
"alert_urgency_id": "03927998-30b3-498c-b209-563d9b1c5569",
"created_at": "2025-03-13T11:58:43.835-07:00",
"updated_at": "2025-03-13T11:58:48.056-07:00",
"webhook_endpoint": "http://localhost:3001/webhooks/incoming/datadog_webhooks/notify/<TYPE>/<ID>",
"sourceable_attributes": {},
"alert_template_attributes": {}
},
"relationships": {
"alert_source_urgency_rules": {
"data": []
}
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
alert_sources The name of the alert source
The alert source type
email, app_dynamics, catchpoint, datadog, alertmanager, google_cloud, grafana, sentry, generic_webhook, cloud_watch, checkly, azure, new_relic, splunk, chronosphere, app_optics, bug_snag, honeycomb, monte_carlo, nagios, prtg ID for the default alert urgency assigned to this alert source
List of rules that define the conditions under which the alert urgency will be set automatically based on the alert payload
JSON path expression to extract a specific value from the alert's payload for evaluation
Comparison operator used to evaluate the extracted value against the specified condition
is, is_not, contains, does_not_contain Value that the extracted payload data is compared to using the specified operator to determine a match
Provide additional attributes for generic_webhook alerts source
Set this to true to auto-resolve alerts based on field_mappings_attributes conditions
This value is matched with the value extracted from alerts payload using JSON path in field_mappings_attributes
Specify rules to auto resolve alerts
Select the field on which the condition to be evaluated
external_id, state, alert_title, alert_external_url, notification_target_type, notification_target_id JSON path expression to extract a specific value from the alert's payload for evaluation
Response
Unique ID of the alert source
alert_sources The name of the alert source
The current status of the alert source
A secret key used to authenticate incoming requests to this alerts source
The URL endpoint of the alert source
Date of creation
Date of last update
ID for the default alert urgency assigned to this alert source
The alert source type
Additional attributes specific to certain alert sources (e.g., generic_webhook), encapsulating source-specific configurations or details
Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/alert_sources/%7Bid%7D \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/vnd.api+json'{
"data": {
"id": "a60d30b7-8fa1-4184-8016-07711554681c",
"type": "alert_sources",
"attributes": {
"name": "GW 2",
"source_type": "datadog",
"status": "setup_incomplete",
"secret": "5d68889f8423f0f6f74840231e3916503851ab676a38dbf1b529caffe95ebe69",
"alert_urgency_id": "03927998-30b3-498c-b209-563d9b1c5569",
"created_at": "2025-03-13T11:58:43.835-07:00",
"updated_at": "2025-03-13T11:58:48.056-07:00",
"webhook_endpoint": "http://localhost:3001/webhooks/incoming/datadog_webhooks/notify/<TYPE>/<ID>",
"sourceable_attributes": {},
"alert_template_attributes": {}
},
"relationships": {
"alert_source_urgency_rules": {
"data": []
}
}
}
}