Create notification route
create_notification_routeCreate a notification route: deliver notifications matching the given kind/severity/cluster/source/application/reference filters to an existing alert destination. To send one application's default-branch CI failures to a channel: kind pipeline_run_failed, application_id, reference_pattern 'main' (or the repository's default branch). Defaults: priority 100, include mode, enabled, no stop-on-match. Pick an existing destination id with list_alert_destinations (create_alert_destination adds a Slack or Teams channel destination; webhook destinations are created in the portal or CLI because their URLs are credentials). Verify the result with preview_notification_routing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"destination_id": "<destination_id>"
},
"name": "create_notification_route"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Single notification kind to match; alternative to kinds. | |
| mode | No | include delivers matches; exclude suppresses them. | |
| kinds | No | Notification kinds to match. With kinds_negated, every kind EXCEPT these. | |
| enabled | No | Whether the route is active (default true). | |
| priority | No | Evaluation order, lower first (default 100). | |
| severity | No | Only notifications of this severity (critical, warning, info); omit for all. | |
| source_id | No | Only notifications from this source identifier. At delivery today a notification's source is the id of the alert that fired, so filter on an alert id. At most 512 bytes and 4 uuids. A source you may not read (another project's cluster, alert, repository and the like) answers Source not found, as preview_notification_routing does. | |
| cluster_id | No | Only notifications from this cluster (UUID); omit for all clusters. | |
| kinds_negated | No | Invert the kinds list: match every kind except the listed ones. | |
| stop_on_match | No | Stop evaluating lower-priority routes when this one matches. | |
| application_id | No | Only notifications about this application (UUID from list_applications), e.g. one application's pipeline failures; omit for all applications. | |
| destination_id | Yes | Alert destination id (UUID) from list_alert_destinations. | |
| reference_pattern | No | Only notifications about a branch, tag or pull request matching this glob: 'main' or 'refs/heads/main' for the main branch (pull requests targeting main do NOT match), 'release/*' within one path segment, 'release/**' across segments, 'pull/*' for every pull request, 'refs/tags/v*' for tags. Omit for all references. |