Embeds

Drop a single monitor into your own site, README, or docs. Two flavours: a compact card iframe and a shields.io-style SVG badge. For embedding a whole status page, see the Status Pages section.

FINDING YOUR EMBED TOKEN

Open the monitor embeds drawer and enable embeds. The drawer shows token-gated URLs for the card, SVG badge, and JSON endpoint. The monitor does not need to be listed publicly.

SINGLE MONITOR CARD

A compact card showing current state and uptime - good for a project homepage or internal wiki tile.

HTML

<iframe
  src="https://keepitalive.dev/embed/monitor/{badge_token}/card?theme=dark"
  width="360" height="140" frameborder="0"
  style="border:0;border-radius:6px;">
</iframe>

SVG BADGE

A shields.io-style SVG rendered on the fly. Perfect for README files or docs - colour follows current status (UP green, DEGRADED orange, DOWN red, PAUSED grey, PENDING blue).

Markdown

![status](https://keepitalive.dev/embed/monitor/{badge_token}/badge.svg)

HTML

<img src="https://keepitalive.dev/embed/monitor/{badge_token}/badge.svg" alt="status">

Markdown - custom label

![api](https://keepitalive.dev/embed/monitor/{badge_token}/badge.svg?label=api)

QUERY PARAMETERS

theme=dark | light - iframe colour scheme (default: dark).
label=<text> - badge only. Overrides the left-hand label (default: "status"). Max 32 chars.

LIMITS

Rate-limited to 120 requests per minute per IP. Responses are cached for 30 seconds - expect up to 30s of staleness.