Notifications

Notifications send job-run and session events to email or an external service. A channel is the destination; a rule selects the events and scope.

Where to configure notifications

• Personal: open Profile → Notifications.
• Team: open Settings → Teams, select a team, then open Notifications.
• One job: open the job or one of its runs and click Notifications.

Personal settings belong to you. Team settings deliver for the selected team and require permission to manage it.

Channels

LakeSail supports five channel types:

Type	Configuration
Email	Your primary email for a personal channel; all current team members for a team channel
Slack	Incoming Webhook URL
Webhook	URL and optional Signing Secret
PagerDuty	Events API v2 Integration Key
Rootly	API Token

Create and test a channel

1. Open your personal or team notification settings.
2. Under Channels, click Add Channel.
3. Enter a name, choose a type, and provide its configuration.
4. Click Create Channel.
5. In the channel list, use Send test notification to verify delivery.

An email channel does not ask you to select recipients. A personal channel uses your primary email; a team channel follows the team's current membership.

Webhook signing

If you set a signing secret, each webhook delivery includes a LakeSail-Signature header in the form sha256=<hex digest>. Verify the HMAC-SHA256 against the raw request body. See Verifying webhook signatures for examples.

Rules

A rule selects:

• Resource Type and Event Types: what happened.
• Scope: organization, your resources, a team, or one resource.
• Channels: where LakeSail sends the notification.
• Enabled: whether the rule is active.

The rule form shows the available event types. Public workload events cover job-run outcomes and session lifecycle changes; infrastructure-only events are not offered to organization members.

Create a personal or team rule

1. Open your personal or team notification settings.
2. Under Rules, click Add Rule.
3. Choose the resource type, events, scope, and channels.
4. Optionally enter a name, then click Create Rule.

These rules send notifications immediately. If you create your first rule before adding any channels, LakeSail creates a default email channel for you or the team.

Subscribe from a job

Open a job or run and click Notifications. Choose the scope, events, channels, and delivery:

• Immediate: send each event as it occurs.
• Daily digest: group supported events into a daily message.
• Weekly digest: group supported events into a weekly message.

The panel disables delivery modes and channels that do not support the selected events.

Recommended setup

For production jobs, start with an immediate rule for Failed and Timeout events. Send it to the team channel used by the people responsible for the job. Add success notifications only when they are useful.

Troubleshooting

• A test works but events do not arrive: check that the rule and channel are enabled, then confirm the event and scope.
• A channel cannot be selected: that channel type does not support the selected event or delivery mode.
• A webhook signature does not match: hash the raw body before JSON parsing or whitespace changes.
• A digest does not arrive: no message is sent when no matching events occur in the digest window.

API reference

• Notifications: manage channels and rules, test a channel, and list available event types.