Quickstart

This walkthrough adds a monitor and publishes a status page using your API token. First, set it as an environment variable:

export SENTIVEL_TOKEN="sv_..."

Confirm the token works

curl https://www.sentivel.com/api/v1/me \
  -H "Authorization: Bearer $SENTIVEL_TOKEN"

You get back the workspace, the token’s role, and its capabilities.

Add a monitor

Creating a monitor also creates its public component. The first check runs on the next poll cycle (within about two minutes).

curl -X POST https://www.sentivel.com/api/v1/monitors \
  -H "Authorization: Bearer $SENTIVEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "API", "target": "https://api.acme.com/health", "expectedStatusCodes": [200] }'

The target is fetched server-side on every poll, so private, loopback, and internal addresses are rejected. Public http(s) only.

Publish a status page

curl -X POST https://www.sentivel.com/api/v1/status-pages \
  -H "Authorization: Bearer $SENTIVEL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Status", "vanityUrl": "acme" }'

Your page is live at https://acme.sentivel.com.

Next steps

Browse the full API reference for every endpoint, field, and response, generated from the live OpenAPI spec at /api/v1/openapi.json.

Introduction Set up with AI

Get started

Monitoring & status

Incidents & on-call

Your workspace

Developers

Next steps

​Next steps

Next steps