Introduction

The Sentinel API allows you to programmatically interact with your monitoring data, manage monitors, and integrate with your existing tools and workflows.

Base URL

The base URL for all API endpoints is:

https://sentinel.rootstuff.io/api/v1

Versioning

/api/v1 is a stability contract. Within v1, changes are additive only: new endpoints and new response fields may appear, but existing fields are never removed, renamed, or changed in meaning. Breaking changes will only ever ship under a new version prefix, announced ahead of time.

Requests to the unversioned /api paths (from before versioning existed) continue to work as a permanent alias of v1, so existing integrations need no changes. New integrations should use /api/v1.

Authentication

The Sentinel API uses token-based authentication. You can generate an API token from your User Settings → API Tokens page. Once you have your token, include it in the Authorization header of your API requests:

Authorization: Bearer YOUR_API_TOKEN

Headers

All API requests must include the following headers:

Accept: application/json
Content-Type: application/json

Example Request

curl "https://sentinel.rootstuff.io/api/v1/monitors" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"