> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happyuptime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# happy monitors

List, create, update, pause, resume, delete, and ad-hoc test monitors.

# happy monitors

```bash
happy monitors list                                     # all monitors
happy monitors get <id-or-name>                         # detail view
happy monitors create [flags]                           # create monitor
happy monitors update <id-or-name> [flags]              # update monitor
happy monitors pause <id-or-name>                       # pause checks
happy monitors resume <id-or-name>                      # un-pause
happy monitors delete <id-or-name>                      # delete + check history
happy monitors check <id-or-name>                       # run an ad-hoc check now
```

## list

```bash
happy monitors list
happy monitors list --status down              # filter by status
happy monitors list --json                     # machine-readable
```

Output: name, status, region count, last-checked timestamp, URL.

## create

```bash
happy monitors create \
  --name "Acme API" \
  --url https://api.acme.com/health \
  --type http \
  --interval 60 \
  --regions us-east,us-west,eu-west \
  --expected-status 200,201
```

| Flag | Default |
|---|---|
| `--name` | (required) |
| `--url` | (required for `http`/`tcp`/`dns`/`keyword`) |
| `--type` | `http` |
| `--interval` | `60` (seconds) |
| `--regions` | `us-east` |
| `--method` | `GET` |
| `--timeout` | `30` (seconds) |
| `--expected-status` | none (any 2xx) |
| `--keyword` | (only for `--type keyword`) |
| `--keyword-type` | `contains` |
| `--heartbeat-url` | (only for `--type heartbeat`) |
| `--ssl-check` | off |
| `--domain-check` | off |

## get

```bash
happy monitors get acme-api
```

Returns the full monitor row + the last 10 check results + uptime % over the past 24h.

## update

```bash
happy monitors update acme-api --interval 30 --regions us-east,us-west,eu-west,ap-southeast
```

## pause / resume

```bash
happy monitors pause acme-api
happy monitors resume acme-api
```

## delete

```bash
happy monitors delete acme-api
```

Asks for confirmation. Use `--yes` to skip.

## check (ad-hoc)

```bash
happy monitors check acme-api
```

Runs the configured probe **right now** from the configured region(s) without scheduling a recurring check. Useful for verifying a deploy.