Skip to main content
POST
Create a synthetic check

Authorizations

Authorization
string
header
required

An sre_ak_* API key holding the api:admin scope (or api:config_read, which every write refuses with read_only_key).

Body

application/json
check_type
string
required

http, tcp, dns

name
string
required
target
string
required
alert_on_failure
boolean
alert_severity
string

critical | high | medium | low | info (default high)

assertions
object
config
object
down_quorum
integer

Reporting locations that must fail before the verdict is down. Omit for unanimous; cannot exceed the number of locations.

enabled
boolean
failure_threshold
integer

Consecutive failures before alerting (default 3).

interval_seconds
integer

How often to probe. Minimum 60.

locations
string[]

Vantage points to probe from; defaults to ["central"].

service
string
timeout_ms
integer

Per-probe timeout, max 30000. Defaults per type when omitted.

Response

Created.