Pulse Overview

Solenoid Pulse is a headless uptime monitoring API that checks HTTP endpoints on a schedule and sends webhook alerts on failure.

No dashboard. No browser. Just API calls and webhooks — built for AI agents, serverless workflows, and programmatic monitoring.

What Pulse does

  • Sends HTTP requests to your endpoints at configurable intervals (15s to 24h)
  • Detects DOWN status from non-2xx responses, timeouts, DNS failures, or bad SSL
  • Sends webhook alerts via Solenoid Relay on state changes (UP/DOWN)
  • Persists state only on transitions — no historical logs, 99% storage savings
  • Checks up to 25 monitors concurrently per batch via async processing

How it works

Pulse runs a four-stage pipeline every 15 seconds:

  • Scheduler fetches monitors due for check from the config database
  • Task queue batches monitors into groups of 25
  • Consumer executes HTTP checks in parallel via Promise.allSettled
  • Storage shards (~500 monitors each) hold in-memory state and persist only on UP/DOWN transitions

All endpoints require a Bearer token. See Authentication.

Status determination

  • UP — final 2xx status code after redirects, response within timeout
  • DOWN — non-2xx, network error, timeout exceeded, or invalid SSL
  • UNKNOWN — initial state before first check

Use cases

  • AI agent health checks — query GET /v1/pulse?status=down before calling dependencies
  • Multi-tenant SaaS — monitor each customer’s webhook endpoint for proactive failure detection
  • Deployment verification — POST /v1/pulse/:monitorId/check immediately after deploy
  • Competitor monitoring — track competitor API uptime, alert on downtime windows

Next steps