# Ionhour

> Ionhour is an uptime monitoring and incident management platform. It watches websites, APIs, cron jobs, and background workers 24/7 and alerts your team the moment something breaks, slows down, or stops running. Checks are outbound probes Ionhour runs against your endpoints on a schedule; Jobs are inbound heartbeats your cron jobs and workers ping to prove they ran. When a monitor fails, Ionhour opens an incident, pages the right people through alert routing, escalation policies, and on-call schedules, and keeps your public status page current. Agents manage it through the hosted MCP server at https://mcp.ionhour.com, the official SDKs, or the REST API.

The web application lives at https://app.ionhour.com and documentation at https://docs.ionhour.com. Every documentation page is also served as markdown: append `.md` to its URL, or request it with `Accept: text/markdown`. The complete documentation set is at https://docs.ionhour.com/llms-full.txt.

## Agent quick start

- [Agent Quick Start](https://docs.ionhour.com/agents/quickstart.md): Read this first. Task-oriented recipes for connecting, auditing, adding, investigating, querying, and changing monitoring.
- [Hosted MCP Server](https://docs.ionhour.com/api-reference/mcp.md): Connect an MCP client to https://mcp.ionhour.com with an `ionh_` API key, and the full tool reference.

## Docs

- [Welcome to Ionhour](https://docs.ionhour.com/index.md): Official Ionhour documentation — uptime monitoring, cron job heartbeats, incident management, on-call scheduling, alerting, and status pages for engineers.
- [Introduction](https://docs.ionhour.com/introduction.md): Go from signup to your first Ionhour alert in a few guided steps — create a workspace, add a check or a heartbeat job, and connect your first alert channel.
- [Dashboard](https://docs.ionhour.com/monitoring/dashboard.md): Review your workspace's overall health at a glance — uptime and incident KPIs, incident history, recommended actions, member activity, and open issue status.
- [Checks (HTTP & Outbound Monitoring)](https://docs.ionhour.com/monitoring/checks.md): Have Ionhour actively probe your websites, APIs, and endpoints on a schedule from multiple regions — creating HTTP checks, linking dependencies, managing them.
- [Jobs (Heartbeat & Cron Monitoring)](https://docs.ionhour.com/monitoring/jobs.md): Monitor cron jobs and background tasks by having them ping Ionhour after every successful run — schedules, grace periods, and alerts when a run goes missing.
- [Dependencies](https://docs.ionhour.com/monitoring/dependencies.md): Track the external services your checks rely on so you can spot the real root cause the moment something breaks — categories, health monitors, and impact maps.
- [Incidents Overview](https://docs.ionhour.com/incidents/overview.md): How Ionhour opens, tracks, and resolves incidents when a check or job goes down, plus declaring incidents by hand and publishing public status page updates.
- [Incident Timeline](https://docs.ionhour.com/incidents/timeline.md): See incidents, deployments, and check status plotted visually across time and grouped by project — pick a range, overlay alerts, and jump into any incident.
- [Maintenance Windows](https://docs.ionhour.com/incidents/maintenance-windows.md): Schedule planned work so checks and incidents in the affected projects stay quiet instead of paging your team — list and calendar views, and full management.
- [Teams](https://docs.ionhour.com/on-call/teams.md): Group workspace members into named teams so you can assign a whole group to schedules and escalation paths — creating, editing, and managing your team rosters.
- [On-Call Schedules](https://docs.ionhour.com/on-call/schedules.md): Define who is on call and when — build rotations, review coverage gaps, and swap responders with overrides so incidents always reach the right person on time.
- [Escalation Paths](https://docs.ionhour.com/on-call/escalation-policies.md): Build the chain of people and teams who get notified, in order, when an incident is not acknowledged — creating policies, best practices, and daily management.
- [Alert Routing](https://docs.ionhour.com/alerting/alert-routing.md): Route alerts to the right escalation policy or channel with rules that match on status, project, or check — how matching works and what actions rules take.
- [Alert Channels](https://docs.ionhour.com/alerting/channels.md): Connect Slack, email, SMS, PagerDuty, and other destinations so alerts reach the right people — messaging, phone, ticketing, and dedicated on-call channels.
- [Notifications (Delivery History)](https://docs.ionhour.com/alerting/notifications.md): Review a log of every alert Ionhour has sent — filter by channel or status, mark rows as read, page through history, and confirm your team was really paged.
- [Status Pages](https://docs.ionhour.com/explore/status-pages.md): Publish a branded page showing the live health of your services so customers can self-serve during incidents — visibility levels, settings, and going live.
- [Testing Lab](https://docs.ionhour.com/explore/testing-lab.md): A safe sandbox for testing ping requests and deployment integrations — exercise the Ping Tester and Deployment Tester before your setup has to matter for real.
- [Deployments](https://docs.ionhour.com/explore/deployments.md): Tell Ionhour when you are releasing code so a restart or missed heartbeat does not trigger a false incident — creating deployments and tracking their impact.
- [Projects](https://docs.ionhour.com/account-workspace/projects.md): Group related checks and jobs into projects so you can monitor, filter, and manage each service on its own — the project picker, settings, and best practices.
- [Workspace Settings](https://docs.ionhour.com/account-workspace/workspace-settings.md): Manage everything about your workspace from one place — general settings, members and roles, notification defaults, billing and usage, and the full audit log.
- [Account Settings](https://docs.ionhour.com/account-workspace/account-settings.md): Manage your personal profile, notification preferences, appearance, and account security — settings that follow you across workspaces, separate from any team.
- [Switching Between Workspaces](https://docs.ionhour.com/account-workspace/switching-workspaces.md): Jump between every workspace you belong to with the workspace switcher, create new ones, and control which workspace Ionhour opens by default each session.
- [Build on Ionhour](https://docs.ionhour.com/developers.md): The Ionhour developer platform — register OAuth apps, request scoped permissions, and receive uptime webhooks, from your first credential to approved install.
- [Developer Console](https://docs.ionhour.com/developers/console.md): The Ionhour developer console — create and manage API credentials, rotate secrets safely, and inspect live request logs to debug your own integrations faster.
- [OAuth apps](https://docs.ionhour.com/developers/oauth-apps.md): Register an OAuth app on the Ionhour developer platform — client types, one-time credentials, configuration, and the full review and distribution lifecycle.
- [Scopes & product APIs](https://docs.ionhour.com/developers/scopes.md): Every OAuth scope on the Ionhour developer platform, grouped by product API — monitoring, incidents, alerting, on-call, and status pages — plus capping rules.
- [Webhooks](https://docs.ionhour.com/developers/webhooks.md): Subscribe your own app to Ionhour events — configuring delivery, the signed envelope format, verifying HMAC signatures, rotating secrets, and retry behavior.
- [Integrations](https://docs.ionhour.com/integrations.md): Build on Ionhour from your own product — declare incidents, post status updates, and receive Ionhour events into your IMS, plus base URL and API conventions.
- [Authentication](https://docs.ionhour.com/integrations/authentication.md): Create an API key, authenticate against /api/v1, and understand permission levels, resource scoping, role projection, rate limits, and workspace isolation.
- [Incidents](https://docs.ionhour.com/integrations/incidents.md): Declare, acknowledge, resolve, and list incidents from your own system through the Ionhour Integration API — the state machine and IMS sync patterns to follow.
- [Status Pages](https://docs.ionhour.com/integrations/status-pages.md): Read authenticated status summaries and post announcements that fan out to your status-page subscribers — list pages, add updates, and resolve them cleanly.
- [Webhooks](https://docs.ionhour.com/integrations/webhooks.md): Receive Ionhour incidents and alerts into your IMS as signed HTTP callbacks — channel setup, payload format, event taxonomy, and signature verification steps.
- [Deployments & Maintenance](https://docs.ionhour.com/integrations/deployments-maintenance.md): Announce deploys and maintenance windows from your own CI so Ionhour pauses probing or suppresses alerts while you work — including a GitHub Actions example.
- [Check Lifecycle](https://docs.ionhour.com/deep-dive/check-lifecycle.md): The complete state machine behind check status transitions — inbound and outbound flows, signal types, validation timing, and multi-region consensus rules.
- [Monitoring Patterns](https://docs.ionhour.com/deep-dive/monitoring-patterns.md): Best practices for reliable monitoring — choosing intervals, tuning grace periods, heartbeat patterns, multi-region strategy, and avoiding false positives.
- [Integration Examples](https://docs.ionhour.com/deep-dive/integration-examples.md): Ready-to-use heartbeat snippets for shell and cron, Node.js, Python, Go, GitHub Actions, and Docker — copy, paste, and start pinging Ionhour within minutes.
- [Analytics & Uptime Reporting](https://docs.ionhour.com/deep-dive/analytics.md): Track uptime, latency, and reliability metrics at the workspace, project, and check level to measure SLA compliance and identify long-term performance trends.
- [Troubleshooting](https://docs.ionhour.com/deep-dive/troubleshooting.md): Diagnose common Ionhour issues across inbound and outbound checks, incidents, and alerts — missed pings, false alarms, and unexpected check status transitions.
- [What's New](https://docs.ionhour.com/changelog.md): A running log of every new Ionhour feature, improvement, and fix across monitoring, alerting, on-call, status pages, and the developer platform, newest first.
- [Developer Terms](https://docs.ionhour.com/legal/developer-terms.md): The terms that govern the Ionhour developer platform — credentials and security, scopes and data, acceptable use, and the app review and distribution process.

## API

- [API Reference](https://docs.ionhour.com/api-reference.md): Complete reference for the Ionhour REST API — authentication, checks, signals, incidents, on-call schedules, status pages, deployments, and event webhooks.
- [Authentication](https://docs.ionhour.com/api-reference/authentication.md): Authenticate with the Ionhour API using API keys or OAuth tokens — which credential goes where, public endpoints, rate limits, and workspace-level scoping.
- [Checks API](https://docs.ionhour.com/api-reference/checks.md): Create, list, update, pause, and delete checks through the Ionhour API — schedules, grace periods, outbound probe configuration, and token-based check lookups.
- [Incidents API](https://docs.ionhour.com/api-reference/incidents.md): List and filter incidents through the Ionhour API — acknowledge and resolve them, add notes, read the full event timeline, and look up every incident field.
- [Signals API](https://docs.ionhour.com/api-reference/signals.md): Send heartbeat pings to Ionhour, report job failures, query historical signal data, and subscribe to real-time signal updates over server-sent events (SSE).
- [Escalation Policies API](https://docs.ionhour.com/api-reference/escalation-policies.md): Create and manage escalation policies through the Ionhour API — build the multi-step rules that route unacknowledged incidents to the right people and teams.
- [On-Call Schedules API](https://docs.ionhour.com/api-reference/on-call-schedules.md): Create and manage on-call schedules through the Ionhour API — rotations, participants, and overrides, plus querying who is currently on call for any given team.
- [Teams API](https://docs.ionhour.com/api-reference/teams.md): Create and manage teams through the Ionhour API — add and remove members, list team rosters, and target entire teams in notifications and escalation paths.
- [Maintenance Windows API](https://docs.ionhour.com/api-reference/maintenance-windows.md): Schedule and manage planned maintenance windows through the Ionhour REST API, suppressing alerts and incident creation while you work on the affected services.
- [Status Pages API](https://docs.ionhour.com/api-reference/status-pages.md): Create and configure status pages through the Ionhour API — manage components, publish announcements, verify custom domains, and serve public status feeds.
- [Deployments API](https://docs.ionhour.com/api-reference/deployments.md): Create deployment windows through the Ionhour API to auto-pause checks during a release, end them to resume monitoring, and list your full deployment history.
- [Dependencies API](https://docs.ionhour.com/api-reference/dependencies.md): Manage external service dependencies through the Ionhour API — create, update, and categorize them, and track their real impact on every service you monitor.
- [MCP Server](https://docs.ionhour.com/api-reference/mcp.md): Connect an MCP client to https://mcp.ionhour.com — transport, API-key authentication and permission levels, per-client setup, safety boundaries, and the full tool reference grouped by resource.
- [OpenAPI Specification](https://api.ionhour.com/api/v1/openapi.json): OpenAPI 3 document for the Integration API v1 (/api/v1): whoami, deployments, maintenance windows, incidents, status pages, and announcements.

## Optional

- [Uptime Monitoring](https://ionhour.com/products/uptime-monitoring): Outbound HTTP checks that probe your websites and APIs from multiple regions.
- [Cron Monitoring](https://ionhour.com/products/cron-monitoring): Heartbeat monitoring for every automated task your business depends on.
- [Incident Management](https://ionhour.com/products/incident-management): Automatic incident creation, acknowledgement, and resolution with on-call schedules and escalation policies.
- [On-Call](https://ionhour.com/products/on-call): Teams, rotations, overrides, and escalation paths so the right responder is paged.
- [Status Pages](https://ionhour.com/products/status-page): Public status pages that show customers everything is running smoothly, or let them know you are on it.
- [MCP Server](https://ionhour.com/products/mcp): Connect AI assistants to your monitoring via the Model Context Protocol to observe systems and take action.
- [Pricing](https://ionhour.com/pricing): Pro at $25/month or $250/year after a 14-day Pro trial; Business is custom-priced; the Free plan is invite-only.
- [About](https://ionhour.com/about): Who builds Ionhour and why.
- [FAQ](https://ionhour.com/faq): Common questions about plans, monitoring, and support.
- [Contact](https://ionhour.com/contact): Sales and support contact: support@ionhour.com.
- [Trust Center](https://ionhour.com/trust): Security controls, sub-processors, and compliance documentation.
- [Security](https://ionhour.com/legal/security)
- [Terms of Service](https://ionhour.com/terms)
- [Privacy Policy](https://ionhour.com/privacy)
- [Data Processing Agreement](https://ionhour.com/legal/dpa)
- [Dashboard](https://app.ionhour.com): The Ionhour web application (sign-up and login).
- [Feedback](https://ionhour.com/feedback): Feature requests and product feedback.