API Reference

RESTful API for Automations

Zero-downtime assurance for modern DevOps. Integrate StatusSentry directly into your CI/CD pipelines and alerting systems.

View Endpoints Download SDKs

Authentication

All API requests to StatusSentry must be authenticated using API Keys. Keys are generated in your Dashboard under Settings > Developers.

API Key Header

Include your secret key in the header of every request. Never expose this key in client-side code.

        Authorization: Bearer sk_live_51Mz...8f9a
      

Rate Limits

Standard tier allows 100 requests per minute. Enterprise tier supports up to 5,000 requests per minute with burst capability.

Scopes

Keys can be restricted to specific scopes: read:status, write:incidents, or admin:config.

Core Endpoints

Manage your monitoring infrastructure programmatically. Base URL: https://api.statussentry.com/v1

List Monitors

GET

Retrieve a list of all active uptime monitors for your organization.

/monitors?active=true

Create Incident

POST

Manually trigger an incident on your public status page. Useful for maintenance windows.

/incidents

Update Alert Rules

PUT

Modify notification channels (Slack, PagerDuty, Email) and severity thresholds.

/alerts/{alert_id}

Code Examples

Quickly integrate StatusSentry into your automation scripts. Here is how to fetch the current uptime percentage for a specific monitor.

Python (Requests)

import requests

url = "https://api.statussentry.com/v1/monitors/mon_7823/health"
headers = {
    "Authorization": "Bearer sk_live_51Mz...8f9a",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json()

print(f"Current Status: {data['status']}")
print(f"Uptime (24h): {data['uptime_percentage']}%")

cURL

curl -X GET "https://api.statussentry.com/v1/monitors/mon_7823/health" \
  -H "Authorization: Bearer sk_live_51Mz...8f9a"