Notification Rules - Vela

Rules watch for events matching a name and optional conditions, then deliver alerts to configured destinations (Slack, Discord, or email).

Destinations are configured in the Vela dashboard. The SDK references them by ID.

List rules

const rules = await appRes.notificationRules.list();

Create a rule

const rule = await appRes.notificationRules.create({
  name: 'Alert on large payment failure',
  eventName: 'payment.failed',
  enabled: true, // optional, defaults to true
  conditions: [
    {
      id: 'cond-1',
      field: 'amountCents',
      operator: 'greater_than',
      value: 10000,
    },
  ],
  actions: [
    {
      id: 'action-1',
      destinationId: 'dest-uuid-here',
      channel: 'slack',
      enabled: true,
    },
  ],
});

Pass an empty conditions array to trigger on every matching event regardless of payload.

Update a rule

// Pause a rule
await appRes.notificationRules.update(rule.id, { enabled: false });

// Update conditions
await appRes.notificationRules.update(rule.id, {
  conditions: [
    { id: 'cond-1', field: 'amountCents', operator: 'greater_than', value: 50000 },
  ],
});

Condition operators

Operator	Description
`equals`	Field strictly equals value
`not_equals`	Field does not equal value
`greater_than`	Numeric field is greater than value
`less_than`	Numeric field is less than value
`contains`	String field contains value as substring
`starts_with`	String field starts with value