Update a heartbeat check

put

https://api.checklyhq.com/v1/checks/heartbeat/{id}

Updates a Heartbeat check.

Path Params

string

required

Query Params

autoAssignAlerts

boolean

Defaults to true

Determines whether a new check will automatically be added as a subscriber to all existing alert channels when it gets created.

Body Params

name

string

The name of the check.

activated

boolean

Defaults to true

Determines if the check is running or not.

muted

boolean

Defaults to false

Determines if any notifications will be send out when a check fails and/or recovers.

doubleCheck

boolean

Defaults to true

[Deprecated] Retry failed check runs. This property is deprecated, and retryStrategy can be used instead.

shouldFail

boolean

Defaults to false

Allows to invert the behaviour of when a check is considered to fail. Allows for validating error status like 404.

locations

array of objects

An array of one or more data center locations where to run this check.

locations

tags

alertSettings

object

Alert settings.

useGlobalAlertSettings

boolean

Defaults to true

When true, the account level alert setting will be used, not the alert setting defined on this check.

groupId

number

Defaults to null

The id of the check group this check is part of.

groupOrder

number

≥ 0

Defaults to null

The position of this check in a check group. It determines in what order checks are run when a group is triggered from the API or from CI/CD.

runtimeId

string

enum

Defaults to null

The runtime version, i.e. fixed set of runtime dependencies, used to execute this check.

Allowed:

alertChannelSubscriptions

array of objects

List of alert channel subscriptions.

alertChannelSubscriptions

triggerIncident

object

Determines whether the check or monitor should create and resolve an incident based on its alert configuration. Useful for status page automation.

runParallel

boolean

Defaults to false

When true, the check will run in parallel in all selected locations.

frequency

integer

Defaults to 10

How often the check should run in minutes.

frequencyOffset

integer

≥ 1

request

object

heartbeat

object

script

string

required

scriptPath

string

Path of the script in the runtime.

sslCheckDomain

string

environmentVariables

array of objects

length ≤ 50

Key/value pairs for setting environment variables during check execution. These are only relevant for Browser checks. Use global environment variables whenever possible.

environmentVariables

setupSnippetId

number

Defaults to null

An ID reference to a snippet to use in the setup phase of an API check.

tearDownSnippetId

number

Defaults to null

An ID reference to a snippet to use in the teardown phase of an API check.

localSetupScript

string

Defaults to null

A valid piece of Node.js code to run in the setup phase.

localTearDownScript

string

Defaults to null

A valid piece of Node.js code to run in the teardown phase.

degradedResponseTime

number

0 to 300000

Defaults to 10000

The response time in milliseconds where a check should be considered degraded.

maxResponseTime

number

0 to 300000

Defaults to 20000

The response time in milliseconds where a check should be considered failing.

Headers

x-checkly-account

string

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Responses

200Successful

401Unauthorized

403Forbidden

429Too Many Requests