Supercheck LogoSupercheck
Status Pages

Update a status page component

Partially update a component. Requires status_page:update. When monitorIds is present the monitor links are replaced atomically. If monitorIds lists at least one monitor and status is omitted, the status is re-derived from the linked monitors; clearing all monitors keeps the current status.

PUT
/api/status-pages/{id}/components/{componentId}

Authorization

bearerAuth
headerAuthorizationBearer <token>

Project-scoped CLI token (sck_live_* or sck_test_*) for documented API operations that accept bearer authentication. Interactive browser operations may require a session cookie. Trigger keys (sck_trigger_* / legacy job_*) are accepted only by job trigger endpoints.

Path Parameters

id*string

Status page ID

Formatuuid
componentId*string

Component ID

Formatuuid

Request Body

application/json
  1. body

Any subset of fields. Omitted fields are preserved.

name?string
Length1 <= length <= 255
description?string
Lengthlength <= 2000
monitorIds?array<>

Monitors of the current project to link. Duplicates are collapsed. On update, replaces the whole set.

Itemsitems <= 100
status?string

Manual status. When omitted while monitors are linked, the status is derived from the monitors.

Value in"operational""degraded_performance""partial_outage""major_outage""under_maintenance"
showcase?boolean

Show the component on the public page.

onlyShowIfDegraded?boolean
position?integer
Range0 <= value <= 1000
aggregationMethod?string
Value in"worst_case""best_case""weighted_average""majority_vote"
autoCreateIncidents?boolean
serviceId?string

AI SRE service in the current project.

Formatuuid
monitorWeights?

Weight per monitor ID (max 100 entries); default weight is 1.

failureThreshold?integer
Range1 <= value <= 100

Response Body

Updated component

application/json
  1. response
component?
Example Request
curl -X PUT 'https://demo.supercheck.dev/api/status-pages/497f6eca-6276-4993-bfeb-53cbbbba6f08/components/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "component": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "description": "string",    "position": 0,    "monitorIds": [      "b097df87-5e66-49a7-b709-53c1c4c15b17"    ],    "status": "operational",    "showcase": true,    "onlyShowIfDegraded": true,    "aggregationMethod": "worst_case",    "failureThreshold": 0,    "autoCreateIncidents": true,    "serviceId": "8f8bb40f-b96b-40fe-9064-5031fbe483f9"  }}

Create a status page component POST

Previous Page

Delete a status page component DELETE

Next Page