Skip to content
Open Console →

Status pages

9 endpoints under /api/v1/status.

GET /api/v1/status/pages #

List the organization's status pages

Each page is a hosted, public hostname (https://<slug>.status.lngbrdg.com) showing the health of chosen services.

Responses

200 The org's status pages.
Response body
  • pagesStatusPage[]required
    Show fields
    • idstringrequired
    • slugstringrequired
    • namestringrequired
    • serviceIdsstring[]required
    • urlstringrequired
    • createdAtstringrequired
401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
POST /api/v1/status/pages #

Create a status page

Claims a public hostname: the slug is globally unique (409 when taken), DNS-label shaped, reserved names rejected — and immutable after create. Unlimited services per page.

Request body

  • slugstringrequired
  • namestringrequired
  • serviceIdsstring · uuid[]required

Responses

201 The created status page.
Response body
  • idstringrequired
  • slugstringrequired
  • namestringrequired
  • serviceIdsstring[]required
  • urlstringrequired
  • createdAtstringrequired
401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
409 The slug is already taken (it names a public hostname).
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
GET /api/v1/status/services #

List the organization's services

The spine a status page's series come from — the same services Uptime manages; Status only reads them. Series per page are never gated.

Responses

200 The org's services.
Response body
  • servicesStatusService[]required
    Show fields
    • idstringrequired
    • namestringrequired
    • createdAtstringrequired
401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
PATCH /api/v1/status/pages/{id} #

Update a status page

Name and/or shown services. The slug is a public hostname — immutable; recreate to move.

Parameters

  • id path string required

Request body

  • namestring
  • serviceIdsstring · uuid[]

Responses

200 The updated status page.
Response body
  • idstringrequired
  • slugstringrequired
  • namestringrequired
  • serviceIdsstring[]required
  • urlstringrequired
  • createdAtstringrequired
401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
DELETE /api/v1/status/pages/{id} #

Delete a status page

Soft delete — the public hostname starts answering 404 immediately.

Parameters

  • id path string required

Responses

204 Deleted.
401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
GET /api/v1/status/maintenances #

List the organization's maintenance windows

Active + upcoming + last-7-days past, newest first. During an active window, alerts on the covered services are recorded but nobody is paged — checks keep running.

Responses

200 The org's maintenance windows.
Response body
  • maintenancesStatusMaintenance[]required
    Show fields
    • idstringrequired
    • titlestringrequired
    • serviceIdsstring[]required
    • startsAtstringrequired
    • endsAtstringrequired
    • createdAtstringrequired
    • statestring · enumrequired

      upcomingactivepast

401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
POST /api/v1/status/maintenances #

Schedule a maintenance window

Schedules (startsAt = timestamp) or starts (startsAt = "now") a window on one or more services: announced on status pages, and while active, alerts are recorded but open no incidents and page no one. Span ≤ 30 days.

Request body

  • titlestringrequired
  • serviceIdsstring · uuid[]required
  • startsAtstringrequired
  • endsAtstringrequired

Responses

201 The created maintenance window.
Response body
  • idstringrequired
  • titlestringrequired
  • serviceIdsstring[]required
  • startsAtstringrequired
  • endsAtstringrequired
  • createdAtstringrequired
  • statestring · enumrequired

    upcomingactivepast

401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
PATCH /api/v1/status/maintenances/{id} #

Move the end of a maintenance window

Extend, shorten, or end now (endsAt = the current instant); the new end must stay after the start. When an active window ends, still-firing suppressed alerts promote to incidents and page.

Parameters

  • id path string required

Request body

  • endsAtstringrequired

Responses

200 The updated maintenance window.
Response body
  • idstringrequired
  • titlestringrequired
  • serviceIdsstring[]required
  • startsAtstringrequired
  • endsAtstringrequired
  • createdAtstringrequired
  • statestring · enumrequired

    upcomingactivepast

401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired
DELETE /api/v1/status/maintenances/{id} #

Cancel a maintenance window

Only while the window has NOT yet started — 409 once active (end it via PATCH endsAt=now instead, so history stays honest).

Parameters

  • id path string required

Responses

204 Cancelled.
401 No valid session.
Response body
  • errorstringrequired
403 Status is not enabled for this organization (private beta).
Response body
  • errorstringrequired
404 Unknown status page.
Response body
  • errorstringrequired
409 The window is already active — end it instead.
Response body
  • errorstringrequired
502 The Lookout service is unreachable.
Response body
  • errorstringrequired