Instatus

API

REST API for managing status page maintenance and incidents

Overview

The Instatus API is an HTTP RESTful interface enabling programmatic creation, update, and management of incidents and maintenance events on Instatus status pages. Key endpoints include incident creation (POST /v1/incidents), incident updates (PATCH /v1/incidents/{id}), maintenance scheduling (POST /v1/maintenances), and event listing (GET /v1/incidents). Responses are JSON-formatted. Use cases include automating incident reports from monitoring tools, syncing maintenance schedules with CI/CD pipelines, and updating status pages in real-time without manual intervention. Authentication uses API keys in request headers.

Example Integration (JavaScript)

script.js JS


fetch('https://instatus.com/help/api')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

RESTful Interface
JSON Response Format
Incident & Maintenance Management
API Key Authentication
Scheduled Maintenance Support

Frequently Asked Questions

? Is Instatus API free to use?

Yes, it is included with all Instatus plans (free and paid). Free tiers have rate limits, while paid plans offer higher limits and advanced capabilities.

? Does it require an API Key?

Absolutely—you need to generate an API key from your Instatus account's settings page to authenticate all API requests.

? What is the response format?

All API responses are returned in JSON format, which is widely supported by most programming languages and tools for easy integration.

Top Alternatives

Atlassian Statuspage API Search Google

Tool Info

Pricing Freemium

Category Business

Platform Public API

Pros

⊕ Automates status page updates
⊕ Integrates with monitoring systems
⊕ Simplifies maintenance scheduling

Cons

⊖ Rate-limited by plan tier
⊖ Requires Instatus account
⊖ Exclusive to Instatus status pages