The public API is included in the Team and Stack plans.

What is the API?

The Watchman Tower API lets scripts and integrations work with your monitors without the dashboard:
  • Create and delete monitors
  • List monitors and read their health, uptime, SSL and domain state
  • Retrieve response time metrics

Core API Goals

RESTful API

Standard REST endpoints with JSON responses

Authentication

Secure API key authentication

Rate Limiting

Per-key limits with rate limit headers on every response

Documentation

Interactive API playground for every endpoint

Base URL

Current API requests use:
https://api.watchmantower.com/public/v1

Use Cases

The API is intended to support workflows such as:
  • Infrastructure as Code: Define monitors in your deployment scripts
  • Custom Dashboards: Build internal status pages with live data
  • Automation: Integrate with CI/CD pipelines and automation tools
  • Data Export: Retrieve historical monitoring data for analysis
  • Third-Party Integrations: Connect Watchman Tower with other services

API Coverage

Endpoints available today:
  • Monitors: create, list, view and delete monitors
  • Metrics: response time statistics for a monitor
Endpoints are listed in the sidebar with request and response examples.

Next Steps

Authentication Guide

Learn how API authentication works

Create Site

Create a new monitoring site

Get Sites

Retrieve all monitoring sites associated with your account

Get Site Detail

Full monitoring picture of one site: health state, uptime, SSL and domain conditions

Dashboard

Use the dashboard alongside API workflows

Alert Overview

Configure alerts and notification routing