Skip to Content
SeyloDocs
API referenceNotifications

Get a service's alert rules

GET
/api/v1/notifications.serviceAlerts

Returns whether a service uses the default alert rules or its own, the rules in effect and the defaults for comparison. Only service events (serviceAlertEvents) apply here.

Needs services.view on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$

Response Body

Success.

application/json
  1. response
useDefaults*boolean
rules*array<>
Itemsitems <= 17
defaults*array<>
Itemsitems <= 17
Example Request
curl -X GET 'https://example.com/api/v1/notifications.serviceAlerts?serviceId=string'
Example Response
{  "useDefaults": true,  "rules": [    {      "event": "crash",      "enabled": true,      "channelIds": [        "string"      ]    }  ],  "defaults": [    {      "event": "crash",      "enabled": true,      "channelIds": [        "string"      ]    }  ]}

Delete a notification channel POST

Deletes a channel and removes it from every alert rule that used it. Needs `notifications.manage`, which owners and admins hold. Available to MCP clients and the assistant, after a person approves the call.

Send a test notification POST

Sends a test message. Pass channelId to test a saved channel, config to test unsaved settings, or both to test edits (secrets left out come from the saved channel). Needs `notifications.manage`, which owners and admins hold. Available to MCP clients and the assistant.