Skip to main content

Status Pages

Create public status pages that display the real-time health of your services. Share them with users, customers, or stakeholders to communicate service availability.

How it works​

  1. Create a status page — give it a name and a unique slug
  2. Add monitors — select which uptime monitors to display
  3. Share the URL — your status page is publicly accessible

Status pages are available at:

https://app.hooklistener.com/status/<slug>

Creating a status page​

From the dashboard​

  1. Navigate to Monitors > Status Pages
  2. Click New Status Page
  3. Enter a name (e.g., "Acme API Status") and slug (e.g., acme-status)
  4. Add monitors to display
  5. Click Create

From the API​

curl -X POST https://app.hooklistener.com/api/v1/status-pages \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "status_page": {
      "name": "Acme API Status",
      "slug": "acme-status"
    }
  }'

Adding monitors to a status page​

curl -X POST https://app.hooklistener.com/api/v1/status-pages/<page-id>/monitors/<monitor-id> \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "API Server",
    "display_order": 1
  }'

Removing monitors from a status page​

curl -X DELETE https://app.hooklistener.com/api/v1/status-pages/<page-id>/monitors/<monitor-id> \
  -H "Authorization: Bearer hklst_your_api_key"

Status page features​

Real-time status​

Each monitor on the status page shows its current state (up or down) along with:

  • Current status indicator — green (up) or red (down)
  • Uptime percentage — over the configured time window
  • Response time — average response time

Public access​

Status pages are publicly accessible. No authentication is required to view them.

Custom display names​

Each monitor on a status page can have a custom display name and order, independent of its internal monitor name.

Managing status pages​

List status pages​

curl https://app.hooklistener.com/api/v1/status-pages \
  -H "Authorization: Bearer hklst_your_api_key"

Update a status page​

curl -X PUT https://app.hooklistener.com/api/v1/status-pages/<page-id> \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "status_page": {
      "name": "Updated Name"
    }
  }'

Delete a status page​

curl -X DELETE https://app.hooklistener.com/api/v1/status-pages/<page-id> \
  -H "Authorization: Bearer hklst_your_api_key"