Skip to content

Set what status pages show for one of an incident's monitors.

PUT
/incident/{incident_id}/monitors/{monitor_type}/{monitor_id}
curl --request PUT \
--url https://api.siteqwality.com/incident/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/monitors/example/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "impact": "degraded" }'

A null or absent impact derives it from the incident’s severity. Returns every monitor of the incident.

incident_id
required
string format: uuid

Incident identifier

monitor_type
required
string

Http, cron, browser, tls, dns, dns_record, page_speed or alert_rule

monitor_id
required
string format: uuid

Monitor identifier

Media type application/json
object
impact
One of:

Null or absent derives it from the incident’s severity.

string
Allowed values: degraded partial_outage major_outage

The incident’s monitors

Media type application/json
Array<object>
object
monitor_id
required
string format: uuid
monitor_type
required
string
Allowed values: http cron browser tls dns dns_record page_speed alert_rule
name

Null when the monitor was deleted.

string | null
impact
One of:

What status pages show for it; null derives it from the incident’s severity.

string
Allowed values: degraded partial_outage major_outage
source
required

auto when a failure joined it, manual when someone added it.

string
Allowed values: auto manual
joined_at
required
string format: date-time
recovered_at
string | null format: date-time
Example
[
{
"monitor_type": "http",
"impact": "degraded",
"source": "auto"
}
]

Unknown monitor_type in the path, or a malformed JSON body

Missing or invalid authentication

Incident not found, or the monitor is not on it

The incident was merged into another; data holds its current state

Unknown impact

Internal server error