Docs

What Status does

Status is a per-project uptime board. Each monitored project exposes a tiny HTTP health endpoint (usually /api/health). A poller calls that endpoint every 5 minutes, records one result per sub-component, and Status publishes a live page per project (/p/[slug]) with uptime bars, a one-year incident calendar, and a JSON API you can embed anywhere.

Connecting a project is a two-part job:

1. You expose a working GET /api/health endpoint (see the contract and code examples).
2. Us register the project (name + slug + health URL) in the Status /admin console — the next poll picks it up automatically.

How a check works

every 5 minutes
  │
  ▼
Cloudflare cron Worker ──POST /api/poll (x-poll-secret)──▶ Status (Vercel)
                                                            │
        loops each enabled project,                        │
        fetch(healthUrl) with a 15s timeout                │
              │                                            │
              ▼                                            ▼
   your store / service                     Supabase „checks" rows
   GET /api/health ──► JSON                        ▲
                                                   │
                              public pages + /api/status/[slug] read this

One checks row is stored per component per poll. The status app is poll-driven — there is no agent, no SDK, and nothing installed on your server.

What you need to provide