Skip to main content

Seiri Quickstart

Seiri monitors jobs and heartbeats with push check-ins.
Create a webhook, copy its ping URL, and ping Seiri when work finishes.
Choose the type: Periodic, Cron, or On-Demand.

For the full job-integration recipe (including AI-agent checklist), see Integrate a job.

1. Sign in to the Dashboard​

  1. Open cloud.seiri.app.
  2. Sign in with email, Google, GitHub, or a passkey.
Seiri login screen
Sign in to Seiri

2. Create a Webhook​

  1. Navigate to Core → Webhooks → + Create Webhook.

  2. Enter a descriptive name (e.g. Nightly backup).

  3. Select the webhook type:

    • Periodic — expect a ping every N seconds
    • Cron — expect a ping on a cron schedule
    • On-Demand — manual / event-driven only (no missed-run alerts)
Create webhook
Create a Periodic, Cron, or On-Demand webhook
  1. Copy the endpoint URL from the ENDPOINT column (copy button).
    The endpoint ID looks like acme-demo:YOUR_REF.

3. Send your first ping​

Heartbeats go to ping.seiri.app, not cloud.seiri.app.

curl -fsS -m 10 https://ping.seiri.app/webhook/acme-demo:YOUR_REF/success

Seiri logs every check-in. Use /fail when the job errors.

4. Monitor a cron job (optional)​

const SEIRI_BASE = process.env.SEIRI_BASE_URL;
// https://ping.seiri.app/webhook/acme-demo:YOUR_REF

async function myJob() {
  // ... work ...
  await fetch(`${SEIRI_BASE}/success`);
}

myJob();

5. Inspect logs and stats​

  1. From Core → Webhooks, open stats (bar-chart icon) or the webhook detail page.
  2. Or check the Dashboard for org-wide health.
  3. For cron schedules, also open Services → Cron Jobs.
Webhooks list with endpoint IDs
ENDPOINT column shows the endpoint ID — copy the full ping URL from here

6. Set up alerts​

  1. When creating or editing a webhook, attach channels.
  2. Supported: Email, Slack, Discord, Teams, Telegram, Ntfy, Webhook, and more.
Create alert channels
Get notified when a check-in is missed or fails

Next steps​