# Happy Uptime

> Uptime monitoring and status pages that tell you WHY things are down, not just that they're down.

## Overview
Happy Uptime monitors your websites, APIs, and services from 25+ global regions, and uniquely monitors the third-party services you depend on (AWS, OpenAI, Stripe, Vercel, etc.). When your service goes down, we automatically correlate it with downstream provider outages and tell you if it's your problem or theirs.

## Key Features
- Multi-region uptime monitoring (HTTP, DNS, TCP, heartbeat, SSL, keyword)
- Downstream dependency monitoring (200+ services including AI/LLM providers)
- Beautiful, customizable status pages (6 templates)
- AI-powered incident analysis and postmortem generation
- Embeddable SVG uptime/status badges and live downtime banners
- On-call scheduling with daily/weekly rotations
- SLA tracking with error budgets
- Config-as-code CLI (happyuptime.yml)

## Quick Start

```bash
# AI Agent bootstrap — create an account and get an API key in one call (no signup needed)
curl -X POST https://happyuptime.com/api/v1/agent/bootstrap \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "name": "Jane"}'
# Returns: { data: { api_key: "hu_...", claim_url: "...", organization_id: "..." } }

# Or if you already have an API key:
curl -X POST https://happyuptime.com/api/v1/monitors \
  -H "Authorization: Bearer hu_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My API", "url": "https://api.example.com/health", "type": "http", "interval": 60}'

# CLI alternative
npm install -g happyuptime-cli

# Heartbeat pings (no auth, for cron jobs)
curl -X POST https://happyuptime.com/api/heartbeat/my-cron-job
```

## Claude Code Skill — One-Command Install

Install the Happy Uptime skill for Claude Code and it will automatically help you set up monitoring, status pages, badges, and alerts:

```bash
mkdir -p .claude/skills/happyuptime && curl -fsSL https://happyuptime.com/skill.md -o .claude/skills/happyuptime/SKILL.md
```

Once installed, prompts like these just work:
- "set up uptime monitoring for my API"
- "create a status page for my app"
- "embed an uptime badge in my README"
- "add a downtime banner to my site"
- "configure alerts for Slack and Discord"
- "set up heartbeat monitoring for my cron jobs"

Download: https://happyuptime.com/skill.md

## API
- REST API at https://happyuptime.com/api/v1
- Authentication: API key (hu_xxx) in Authorization header
- API Docs: https://happyuptime.com/docs
- Docs as markdown: https://happyuptime.com/docs.md
- OpenAPI Spec: https://happyuptime.com/openapi.json
- Scopes: read (GET), write (GET+POST+PUT+DELETE), admin (full access)

## Embeddable Widgets (Public, No Auth — use status page ID)
- Uptime badge: https://happyuptime.com/api/v1/badges/{statusPageId}/uptime.svg
- Status badge: https://happyuptime.com/api/v1/badges/{statusPageId}/status.svg
- Response time badge: https://happyuptime.com/api/v1/badges/{statusPageId}/response-time.svg
- Status JSON: https://happyuptime.com/api/v1/widgets/{statusPageId}/status.json
- Downtime banner: https://happyuptime.com/api/v1/widgets/{statusPageId}/embed.js

## Pricing
- Free: 25 monitors, 1-min checks, 3 status pages
- Pro ($12/mo): 100 monitors, 30s checks, visual regression
- Team ($39/mo): 500 monitors, AI features, white-label

## Links
- Website: https://happyuptime.com
- Pricing: https://happyuptime.com/pricing
- Speed Test: https://happyuptime.com/speed-test
- Service Status Directory: https://happyuptime.com/is-down
- CLI on npm: https://www.npmjs.com/package/happyuptime-cli
- Claude Code Skill: https://happyuptime.com/skill.md

## Machine-Readable Resources
- OpenAPI spec: https://happyuptime.com/openapi.json
- Markdown docs: https://happyuptime.com/docs.md
- Full LLM reference: https://happyuptime.com/llms-full.txt
- Claude Code skill: https://happyuptime.com/skill.md