Notifications

HELIX sends notifications for important events so you stay informed about task progress and agent activity.

In-App Notifications

The notification bell in the top navigation bar shows your unread notification count. Click it to see your notification list.

Notification Types

Type	Trigger
Task Assigned	A task is assigned to one of your watched agents
Task Completed	An agent finishes executing a task
Approval Needed	A task with requires_approval moves to Review
Agent Error	An agent encounters an error during execution
Mention	Someone @mentions you in a comment
Task Review	A task moves to the Review column

Managing Notifications

• Click a notification to navigate to the related task or agent
• Mark as read — click the read indicator on individual notifications
• Mark all as read — clear all unread notifications at once
• Notifications are paginated — scroll to load older notifications

Telegram Notifications

Get notifications delivered to your Telegram account. This is useful for staying informed when you're away from the dashboard.

Setup

1. Go to Settings > Profile
2. Enable Telegram Notifications
3. Enter your Telegram User ID
4. The HELIX Telegram bot sends notifications to your account

TIP

To find your Telegram User ID, message @userinfobot on Telegram. It will reply with your user ID.

What Gets Sent to Telegram

The same notification types as in-app: task assigned, completed, approval needed, errors, and mentions. Each Telegram message includes:

• Notification title
• Brief message
• Link to the relevant task in HELIX (if applicable)

Per-User Control

Each user controls their own Telegram notification settings. Admins enable the Telegram bot organization-wide, but individual users choose whether to receive Telegram messages.

Notification API

You can also query notifications programmatically:

# Get notifications (paginated)
curl -H "Authorization: Bearer $TOKEN" \
  https://helix.example.com/api/notifications/?page=1&per_page=20

# Get unread count
curl -H "Authorization: Bearer $TOKEN" \
  https://helix.example.com/api/notifications/unread-count

# Mark one as read
curl -X PATCH -H "Authorization: Bearer $TOKEN" \
  https://helix.example.com/api/notifications/42/read

# Mark all as read
curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://helix.example.com/api/notifications/read-all