API capabilities continue to evolve. Use this section as the reference point for the current public API surface and upcoming programmatic workflows.
What is the API?
The Watchman Tower API provides a programmatic path into Watchman Tower workflows, including:- Create and manage monitors
- Configure alert channels
- Retrieve monitoring data and metrics
- Manage incidents and downtime
- Automate workflows and integrations
Core API Goals
RESTful API
Standard REST endpoints with JSON responses
Authentication
Secure API key authentication
Rate Limiting
Fair usage limits based on your plan
Webhooks
Event-driven integrations where supported
SDKs
Integration options for developer workflows
Documentation
Interactive API playground and comprehensive docs
Base URL
Current API requests use: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
Current and evolving API coverage includes areas such as:- Monitors: Create, read, update, delete monitors
- Incidents: Access incident history and details
- Alerts: Manage alert channels and preferences
- Metrics: Retrieve uptime and performance data
- Account: Manage API keys and account settings
