NAV Navigation
curl

Checkly API V1 (beta)

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

Checkly public API

Base URLs:

Authentication

The Checkly API uses API keys to authenticate requests. You can manage your API keys in the Checkly account settings. Your API key is like a password: keep it secure!

Authentication to the API is performed using the bearer auth method in the Authorization header.

For example, use -H "Authorization: Bearer " when using cURL.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Alert channels

List all alert channels

Code samples

curl -X GET https://api.checklyhq.com/v1/alert-channels \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/alert-channels

Lists all configured alert channels and their subscribed checks.

Parameters

Name In Type Description
limit query number none
page query number none

Example responses

200 Response

[
  {
    "id": 0,
    "type": "string",
    "config": {},
    "subscriptions": [
      {
        "id": 0,
        "checkId": "string",
        "activated": true
      }
    ],
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful AlertChannelsList
401 Unauthorized Unauthorized Model_1

Retrieve an alert channel

Code samples

curl -X GET https://api.checklyhq.com/v1/alert-channels/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/alert-channels/{id}

Show details of a specific alert channel.

Parameters

Name In Type Description
id
(required)
path number none

Example responses

200 Response

{
  "id": 0,
  "type": "string",
  "config": {},
  "subscriptions": [
    {
      "id": 0,
      "checkId": "string",
      "activated": true
    }
  ],
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful AlertChannel
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Update the subscriptions of an alert channel

Code samples

curl -X PUT https://api.checklyhq.com/v1/alert-channels/{id}/subscriptions \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/alert-channels/{id}/subscriptions

Update the subscriptions of an alert channel. Use this to add a check to an alert channel so failure and recovery alerts are send out for that check.

Body parameter

{
  "id": 0,
  "checkId": "string",
  "activated": true
}

Parameters

Name In Type Description
id
(required)
path number none
body body SubscriptionSchema none

Example responses

200 Response

{
  "id": 0,
  "checkId": "string",
  "activated": true
}

Responses

Status Meaning Description Schema
200 OK Successful SubscriptionSchema
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Check groups

List all check groups

Code samples

curl -X GET https://api.checklyhq.com/v1/check-groups \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-groups

Lists all current check groups in your account. The "checks" property is an array of check UUID's for convenient referencing. It is read only and you cannot use it to add checks to a group.

Parameters

Name In Type Description
limit query number none
page query number none

Example responses

200 Response

[
  {
    "id": 0,
    "name": "string",
    "activated": true,
    "muted": true,
    "tags": [
      "string"
    ],
    "locations": [
      "string"
    ],
    "concurrency": 3,
    "apiCheckDefaults": {
      "url": "",
      "headers": [],
      "queryParameters": [],
      "assertions": [],
      "basicAuth": {
        "username": "",
        "password": ""
      }
    },
    "browserCheckDefaults": {},
    "environmentVariables": [
      {
        "key": "string",
        "value": "",
        "locked": false
      }
    ],
    "doubleCheck": true,
    "useGlobalAlertSettings": true,
    "alertSettings": {
      "escalationType": "RUN_BASED",
      "runBasedEscalation": {
        "failedRunThreshold": 1
      },
      "timeBasedEscalation": {
        "minutesFailingThreshold": 5
      },
      "reminders": {
        "amount": 0,
        "interval": 5
      },
      "sslCertificates": {
        "enabled": false,
        "alertThreshold": 30
      }
    },
    "alertChannelSubscriptions": [
      {
        "alertChannelId": 0,
        "activated": true
      }
    ],
    "setupSnippetId": 0,
    "tearDownSnippetId": 0,
    "localSetupScript": "string",
    "localTearDownScript": "string",
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful CheckGroupList
401 Unauthorized Unauthorized Model_1

Create a check group

Code samples

curl -X POST https://api.checklyhq.com/v1/check-groups \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

POST /v1/check-groups

Creates a new check group. You can add checks to the group by setting the "groupId" property of individual checks.

Body parameter

{
  "name": "string",
  "activated": true,
  "muted": false,
  "tags": [
    "string"
  ],
  "locations": [
    "us-east-1"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {},
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string"
}

Parameters

Name In Type Description
body body Model_5 none

Example responses

201 Response

{
  "id": 0,
  "name": "string",
  "activated": true,
  "muted": true,
  "tags": [
    "string"
  ],
  "locations": [
    "string"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {
    "url": "",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
201 Created Created Model_2
401 Unauthorized Unauthorized Model_1
402 Payment Required Payment Required Model_1

Retrieve one check in a specific group with group settings applied

Code samples

curl -X GET https://api.checklyhq.com/v1/check-groups/{groupId}/checks/{checkId} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-groups/{groupId}/checks/{checkId}

Show details of one check in a specific check group with the group settings applied.

Parameters

Name In Type Description
groupId
(required)
path number none
checkId
(required)
path string none

Example responses

200 Response

{
  "id": "string",
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0,
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "alertChannels": {
    "email": [
      {
        "address": ""
      }
    ],
    "webhook": [
      {
        "name": "",
        "url": "",
        "method": "POST",
        "headers": [],
        "queryParameters": []
      }
    ],
    "slack": [
      {
        "url": ""
      }
    ],
    "sms": [
      {
        "number": "",
        "name": "string"
      }
    ]
  },
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful CheckGroupCheck
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Delete a check group.

Code samples

curl -X DELETE https://api.checklyhq.com/v1/check-groups/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

DELETE /v1/check-groups/{id}

Permanently removes a check group. You cannot delete a check group if it still contains checks.

Parameters

Name In Type Description
id
(required)
path number none

Example responses

204 Response

"string"

Responses

Status Meaning Description Schema
204 No Content No Content string
401 Unauthorized Unauthorized Model_1
409 Conflict Conflict Model_1

Retrieve a check group

Code samples

curl -X GET https://api.checklyhq.com/v1/check-groups/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-groups/{id}

Show details of a specific check group

Parameters

Name In Type Description
id
(required)
path number none

Example responses

200 Response

{
  "id": 0,
  "name": "string",
  "activated": true,
  "muted": true,
  "tags": [
    "string"
  ],
  "locations": [
    "string"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {
    "url": "",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Model_2
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Update a check group

Code samples

curl -X PUT https://api.checklyhq.com/v1/check-groups/{id} \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/check-groups/{id}

Updates a check group.

Body parameter

{
  "name": "string",
  "activated": true,
  "muted": false,
  "tags": [
    "string"
  ],
  "locations": [
    "us-east-1"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {},
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string"
}

Parameters

Name In Type Description
id
(required)
path number none
body body Model_9 none

Example responses

200 Response

{
  "id": 0,
  "name": "string",
  "activated": true,
  "muted": true,
  "tags": [
    "string"
  ],
  "locations": [
    "string"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {
    "url": "",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Model_2
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Retrieve all checks in a specific group with group settings applied

Code samples

curl -X GET https://api.checklyhq.com/v1/check-groups/{id}/checks \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-groups/{id}/checks

Lists all checks in a specific check group with the group settings applied.

Parameters

Name In Type Description
id
(required)
path number none
limit query number none
page query number none

Example responses

200 Response

[
  {
    "id": "string",
    "name": "string",
    "checkType": "BROWSER",
    "frequency": 5,
    "activated": true,
    "muted": false,
    "doubleCheck": true,
    "sslCheck": true,
    "shouldFail": true,
    "locations": [
      "us-east-1"
    ],
    "request": {
      "method": "GET",
      "url": "localhost",
      "followRedirects": true,
      "body": "",
      "bodyType": "NONE",
      "headers": [],
      "queryParameters": [],
      "assertions": [],
      "basicAuth": {
        "username": "",
        "password": ""
      }
    },
    "script": "string",
    "environmentVariables": [
      {
        "key": "string",
        "value": "",
        "locked": false
      }
    ],
    "tags": [
      "string"
    ],
    "setupSnippetId": 0,
    "tearDownSnippetId": 0,
    "localSetupScript": "string",
    "localTearDownScript": "string",
    "alertSettings": {
      "escalationType": "RUN_BASED",
      "runBasedEscalation": {
        "failedRunThreshold": 1
      },
      "timeBasedEscalation": {
        "minutesFailingThreshold": 5
      },
      "reminders": {
        "amount": 0,
        "interval": 5
      },
      "sslCertificates": {
        "enabled": false,
        "alertThreshold": 30
      }
    },
    "useGlobalAlertSettings": true,
    "degradedResponseTime": 10000,
    "maxResponseTime": 20000,
    "groupId": 0,
    "groupOrder": 0,
    "alertChannelSubscriptions": [
      {
        "alertChannelId": 0,
        "activated": true
      }
    ],
    "alertChannels": {
      "email": [
        {
          "address": ""
        }
      ],
      "webhook": [
        {
          "name": "",
          "url": "",
          "method": "POST",
          "headers": [],
          "queryParameters": []
        }
      ],
      "slack": [
        {
          "url": ""
        }
      ],
      "sms": [
        {
          "number": "",
          "name": "string"
        }
      ]
    },
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful CheckGroupChecksList
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Check results (rolled up)

Lists all rolled up check results

Code samples

curl -X GET https://api.checklyhq.com/v1/check-results-rolled-up/{checkId} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-results-rolled-up/{checkId}

Lists the rolled up check results per hour for a specific check.

This means that one hour after a raw result for a check is recorded, it is also available in the rolled up results.

The result contains all discrete response times and aggregated counters for failing and successful check. Using this data you can reconstruct averages, percentiles and ratios, approximating the individual raw check results very closely.

You can filter by check type and result type to narrow down the list. Use the to and from parameters to specify a date range. Depending on the check type, some fields might be null.

Note that results from this endpoint start at roughly 2019-4-11, earlier results are not available.

Parameters

Name In Type Description
checkId
(required)
path string none
limit query number none
page query number none
location query string Provide a data center location, e.g. "eu-west-1" to filter by location
to query number Select results up to this UNIX timestamp date, i.e. < date
from query number Select results from this UNIX timestamp date, i.e. >= date

Example responses

200 Response

[
  {
    "checkId": "string",
    "runLocation": "string",
    "errorCount": 0,
    "failureCount": 0,
    "resultsCount": 0,
    "hour": "2019-08-24",
    "responseTimes": [
      "string"
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK Successful RolledUpCheckResultsList
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Check results

Lists all check results

Code samples

curl -X GET https://api.checklyhq.com/v1/check-results/{checkId} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-results/{checkId}

Lists the full, raw check results for a specific check. We keep raw results for 30 days. After 30 days they are erased. However we keep the rolled up results for an indefinite period.

You can filter by check type and result type to narrow down the list. Use the to and from parameters to specify a date range (UNIX timestamp in seconds). Depending on the check type, some fields might be null.

Parameters

Name In Type Description
checkId
(required)
path string none
limit query number none
page query number none
location query string Provide a data center location, e.g. "eu-west-1" to filter by location
to query number Select results up to this UNIX timestamp date in seconds, i.e. < date
from query number Select results from this UNIX timestamp date in seconds, i.e. >= date
checkType query string The type of the check
hasFailures query boolean Check result has one or more failures

Enumerated Values

Parameter Value
checkType BROWSER
checkType API

Example responses

200 Response

[
  {
    "id": "string",
    "name": "string",
    "checkId": "string",
    "hasFailures": true,
    "hasErrors": true,
    "isDegraded": true,
    "overMaxResponseTime": true,
    "runLocation": "string",
    "startedAt": "2019-08-24",
    "stoppedAt": "2019-08-24",
    "created_at": "2019-08-24",
    "responseTime": 0,
    "apiCheckResult": {},
    "browserCheckResult": {},
    "checkRunId": 0,
    "attempts": 0
  }
]

Responses

Status Meaning Description Schema
200 OK Successful CheckResultsList
401 Unauthorized Unauthorized Model_1

Retrieve a check result

Code samples

curl -X GET https://api.checklyhq.com/v1/check-results/{checkId}/{checkResultId} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-results/{checkId}/{checkResultId}

Show details of a specific check result.

Parameters

Name In Type Description
checkId
(required)
path string none
checkResultId
(required)
path string none

Example responses

200 Response

{
  "id": "string",
  "name": "string",
  "checkId": "string",
  "hasFailures": true,
  "hasErrors": true,
  "isDegraded": true,
  "overMaxResponseTime": true,
  "runLocation": "string",
  "startedAt": "2019-08-24",
  "stoppedAt": "2019-08-24",
  "created_at": "2019-08-24",
  "responseTime": 0,
  "apiCheckResult": {},
  "browserCheckResult": {},
  "checkRunId": 0,
  "attempts": 0
}

Responses

Status Meaning Description Schema
200 OK Successful CheckResult
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Check status

List all check statuses

Code samples

curl -X GET https://api.checklyhq.com/v1/check-statuses \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-statuses

Shows the current status information for all checks in your account. The check status records are continuously updatedas new check results come in.

Example responses

200 Response

[
  {
    "checkId": "string",
    "hasFailures": true,
    "hasErrors": true,
    "isDegraded": true,
    "longestRun": 0,
    "shortestRun": 0,
    "lastRunLocation": "string",
    "lastCheckRunId": "string",
    "sslDaysRemaining": 0,
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful CheckStatusList
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Retrieve check status details

Code samples

curl -X GET https://api.checklyhq.com/v1/check-statuses/{checkId} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/check-statuses/{checkId}

Show the current status information for a specific check.

Parameters

Name In Type Description
checkId
(required)
path string none

Example responses

200 Response

{
  "checkId": "string",
  "hasFailures": true,
  "hasErrors": true,
  "isDegraded": true,
  "longestRun": 0,
  "shortestRun": 0,
  "lastRunLocation": "string",
  "lastCheckRunId": "string",
  "sslDaysRemaining": 0,
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful CheckStatus
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Checks

List all checks

Code samples

curl -X GET https://api.checklyhq.com/v1/checks \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/checks

Lists all current checks in your account.

Parameters

Name In Type Description
limit query number none
page query number none

Example responses

200 Response

[
  {
    "id": "string",
    "name": "string",
    "checkType": "BROWSER",
    "frequency": 5,
    "activated": true,
    "muted": false,
    "doubleCheck": true,
    "sslCheck": true,
    "shouldFail": true,
    "locations": [
      "us-east-1"
    ],
    "request": {
      "method": "GET",
      "url": "localhost",
      "followRedirects": true,
      "body": "",
      "bodyType": "NONE",
      "headers": [],
      "queryParameters": [],
      "assertions": [],
      "basicAuth": {
        "username": "",
        "password": ""
      }
    },
    "script": "string",
    "environmentVariables": [
      {
        "key": "string",
        "value": "",
        "locked": false
      }
    ],
    "tags": [
      "string"
    ],
    "setupSnippetId": 0,
    "tearDownSnippetId": 0,
    "localSetupScript": "string",
    "localTearDownScript": "string",
    "alertSettings": {
      "escalationType": "RUN_BASED",
      "runBasedEscalation": {
        "failedRunThreshold": 1
      },
      "timeBasedEscalation": {
        "minutesFailingThreshold": 5
      },
      "reminders": {
        "amount": 0,
        "interval": 5
      },
      "sslCertificates": {
        "enabled": false,
        "alertThreshold": 30
      }
    },
    "useGlobalAlertSettings": true,
    "degradedResponseTime": 10000,
    "maxResponseTime": 20000,
    "groupId": 0,
    "groupOrder": 0,
    "alertChannelSubscriptions": [
      {
        "alertChannelId": 0,
        "activated": true
      }
    ],
    "alertChannels": {
      "email": [
        {
          "address": ""
        }
      ],
      "webhook": [
        {
          "name": "",
          "url": "",
          "method": "POST",
          "headers": [],
          "queryParameters": []
        }
      ],
      "slack": [
        {
          "url": ""
        }
      ],
      "sms": [
        {
          "number": "",
          "name": "string"
        }
      ]
    },
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful CheckList
401 Unauthorized Unauthorized Model_1

Create a check

Code samples

curl -X POST https://api.checklyhq.com/v1/checks \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

POST /v1/checks

Creates a new API or browser check. Will return a 402 when you are over the limit of your plan. When using the globalAlertSetting, the alertSetting can be null

Body parameter

{
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0
}

Parameters

Name In Type Description
body body CheckCreate none

Example responses

201 Response

{
  "id": "string",
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0,
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "alertChannels": {
    "email": [
      {
        "address": ""
      }
    ],
    "webhook": [
      {
        "name": "",
        "url": "",
        "method": "POST",
        "headers": [],
        "queryParameters": []
      }
    ],
    "slack": [
      {
        "url": ""
      }
    ],
    "sms": [
      {
        "number": "",
        "name": "string"
      }
    ]
  },
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
201 Created Created Check
401 Unauthorized Unauthorized Model_1
402 Payment Required Payment Required Model_1

Delete a check

Code samples

curl -X DELETE https://api.checklyhq.com/v1/checks/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

DELETE /v1/checks/{id}

Permanently removes a API or browser check and all its related status and results data.

Parameters

Name In Type Description
id
(required)
path string none

Example responses

204 Response

"string"

Responses

Status Meaning Description Schema
204 No Content No Content string
401 Unauthorized Unauthorized Model_1

Retrieve a check

Code samples

curl -X GET https://api.checklyhq.com/v1/checks/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/checks/{id}

Show details of a specific API or browser check

Parameters

Name In Type Description
id
(required)
path string none

Example responses

200 Response

{
  "id": "string",
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0,
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "alertChannels": {
    "email": [
      {
        "address": ""
      }
    ],
    "webhook": [
      {
        "name": "",
        "url": "",
        "method": "POST",
        "headers": [],
        "queryParameters": []
      }
    ],
    "slack": [
      {
        "url": ""
      }
    ],
    "sms": [
      {
        "number": "",
        "name": "string"
      }
    ]
  },
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Check
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Update a check

Code samples

curl -X PUT https://api.checklyhq.com/v1/checks/{id} \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/checks/{id}

Updates a new API or browser check.

Body parameter

{
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0
}

Parameters

Name In Type Description
id
(required)
path string none
body body Model_14 none

Example responses

200 Response

{
  "id": "string",
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0,
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "alertChannels": {
    "email": [
      {
        "address": ""
      }
    ],
    "webhook": [
      {
        "name": "",
        "url": "",
        "method": "POST",
        "headers": [],
        "queryParameters": []
      }
    ],
    "slack": [
      {
        "url": ""
      }
    ],
    "sms": [
      {
        "number": "",
        "name": "string"
      }
    ]
  },
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Check
401 Unauthorized Unauthorized Model_1

Dashboards

List all dashboards

Code samples

curl -X GET https://api.checklyhq.com/v1/dashboards \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/dashboards

Lists all current dashboards in your account.

Parameters

Name In Type Description
limit query number none
page query number none

Example responses

200 Response

[
  {
    "customUrl": "string",
    "customDomain": "string",
    "logo": "string",
    "header": "string",
    "width": "FULL",
    "refreshRate": 60,
    "paginate": true,
    "paginationRate": 30,
    "tags": [
      "string"
    ],
    "hideTags": false,
    "dashboardId": "string"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful DashboardsList
401 Unauthorized Unauthorized Model_1

Create a dashboard

Code samples

curl -X POST https://api.checklyhq.com/v1/dashboards \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

POST /v1/dashboards

Creates a new dashboard. Will return a 409 when attempting to create a dashboard with a custom URL or custom domain that is already taken.

Body parameter

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false
}

Parameters

Name In Type Description
body body DashboardSchema none

Example responses

201 Response

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false,
  "dashboardId": "string"
}

Responses

Status Meaning Description Schema
201 Created Created DashboardResponse
401 Unauthorized Unauthorized Model_1
409 Conflict Conflict Model_1

Delete a dashboard

Code samples

curl -X DELETE https://api.checklyhq.com/v1/dashboards/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

DELETE /v1/dashboards/{id}

Permanently removes a dashboard.

Parameters

Name In Type Description
id
(required)
path string none

Example responses

204 Response

"string"

Responses

Status Meaning Description Schema
204 No Content No Content string
401 Unauthorized Unauthorized Model_1

Retrieve a dashboard

Code samples

curl -X GET https://api.checklyhq.com/v1/dashboards/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/dashboards/{id}

Show details of a specific dashboard.

Parameters

Name In Type Description
id
(required)
path string none

Example responses

200 Response

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false,
  "dashboardId": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful DashboardResponse
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Update a dashboard

Code samples

curl -X PUT https://api.checklyhq.com/v1/dashboards/{id} \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/dashboards/{id}

Updates a dashboard. Will return a 409 when attempting to create a dashboard with a custom URL or custom domain that is already taken.

Body parameter

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false
}

Parameters

Name In Type Description
id
(required)
path string none
body body DashboardSchema none

Example responses

200 Response

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false,
  "dashboardId": "string"
}

Responses

Status Meaning Description Schema
200 OK Successful DashboardResponse
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1
409 Conflict Conflict Model_1

Maintenance windows

List all maintenance windows

Code samples

curl -X GET https://api.checklyhq.com/v1/maintenance-windows \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/maintenance-windows

Lists all maintenance windows in your account.

Parameters

Name In Type Description
limit query integer none
page query integer none

Example responses

200 Response

[
  {
    "id": 0,
    "name": "string",
    "tags": [
      "string"
    ],
    "startsAt": "2019-08-24",
    "endsAt": "2019-08-24",
    "repeatInterval": 1,
    "repeatUnit": "DAY",
    "repeatEndsAt": "2019-08-24",
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful MaintenanceWindowsList
401 Unauthorized Unauthorized Model_1
403 Forbidden Forbidden Model_1

Create a maintenance window

Code samples

curl -X POST https://api.checklyhq.com/v1/maintenance-windows \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

POST /v1/maintenance-windows

Creates a new maintenance window.

Body parameter

{
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24"
}

Parameters

Name In Type Description
body body Model_20 none

Example responses

201 Response

{
  "id": 0,
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
201 Created Created Model_18
401 Unauthorized Unauthorized Model_1
403 Forbidden Forbidden Model_1

Delete a maintenance window

Code samples

curl -X DELETE https://api.checklyhq.com/v1/maintenance-windows/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

DELETE /v1/maintenance-windows/{id}

Permanently removes a maintenance window.

Parameters

Name In Type Description
id
(required)
path integer none

Example responses

204 Response

"string"

Responses

Status Meaning Description Schema
204 No Content No Content string
401 Unauthorized Unauthorized Model_1
403 Forbidden Forbidden Model_1
404 Not Found Not Found Model_1

Retrieve a maintenance window

Code samples

curl -X GET https://api.checklyhq.com/v1/maintenance-windows/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/maintenance-windows/{id}

Show details of a specific maintenance window.

Parameters

Name In Type Description
id
(required)
path integer none

Example responses

200 Response

{
  "id": 0,
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Model_18
401 Unauthorized Unauthorized Model_1
403 Forbidden Forbidden Model_1
404 Not Found Not Found Model_1

Update a maintenance window

Code samples

curl -X PUT https://api.checklyhq.com/v1/maintenance-windows/{id} \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/maintenance-windows/{id}

Updates a maintenance window.

Body parameter

{
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24"
}

Parameters

Name In Type Description
id
(required)
path integer none
body body Model_20 none

Example responses

200 Response

{
  "id": 0,
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Model_18
401 Unauthorized Unauthorized Model_1
403 Forbidden Forbidden Model_1
404 Not Found Not Found Model_1

Snippets

List all snippets

Code samples

curl -X GET https://api.checklyhq.com/v1/snippets \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/snippets

Lists all current snippets in your account.

Parameters

Name In Type Description
limit query number none
page query number none

Example responses

200 Response

[
  {
    "id": 0,
    "name": "string",
    "script": "string",
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Responses

Status Meaning Description Schema
200 OK Successful SnippetsList
401 Unauthorized Unauthorized Model_1

Create a snippet

Code samples

curl -X POST https://api.checklyhq.com/v1/snippets \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

POST /v1/snippets

Creates a new snippet.

Body parameter

{
  "name": "string",
  "script": "string"
}

Parameters

Name In Type Description
body body SnippetCreate none

Example responses

201 Response

{
  "id": 0,
  "name": "string",
  "script": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
201 Created Created Snippet
401 Unauthorized Unauthorized Model_1

Delete a snippet

Code samples

curl -X DELETE https://api.checklyhq.com/v1/snippets/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

DELETE /v1/snippets/{id}

Permanently removes a snippet.

Parameters

Name In Type Description
id
(required)
path number none

Example responses

204 Response

"string"

Responses

Status Meaning Description Schema
204 No Content No Content string
401 Unauthorized Unauthorized Model_1

Retrieve a snippet

Code samples

curl -X GET https://api.checklyhq.com/v1/snippets/{id} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/snippets/{id}

Show details of a specific snippet.

Parameters

Name In Type Description
id
(required)
path number none

Example responses

200 Response

{
  "id": 0,
  "name": "string",
  "script": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Snippet
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Update a snippet

Code samples

curl -X PUT https://api.checklyhq.com/v1/snippets/{id} \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/snippets/{id}

Updates a snippet.

Body parameter

{
  "name": "string",
  "script": "string"
}

Parameters

Name In Type Description
id
(required)
path number none
body body SnippetCreate none

Example responses

200 Response

{
  "id": 0,
  "name": "string",
  "script": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Responses

Status Meaning Description Schema
200 OK Successful Snippet
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Environment variables

List all environment variables

Code samples

curl -X GET https://api.checklyhq.com/v1/variables \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/variables

Lists all current environment variables in your account.

Parameters

Name In Type Description
limit query number none
page query number none

Example responses

200 Response

[
  {
    "key": "string",
    "value": "",
    "locked": false
  }
]

Responses

Status Meaning Description Schema
200 OK Successful EnvironmentVariablesList
401 Unauthorized Unauthorized Model_1

Create a environment variable

Code samples

curl -X POST https://api.checklyhq.com/v1/variables \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

POST /v1/variables

Creates a new environment variable.

Body parameter

{
  "key": "string",
  "value": "",
  "locked": false
}

Parameters

Name In Type Description
body body EnvironmentVariable none

Example responses

201 Response

{
  "key": "string",
  "value": "",
  "locked": false
}

Responses

Status Meaning Description Schema
201 Created Created EnvironmentVariable
401 Unauthorized Unauthorized Model_1

Delete an environment variable

Code samples

curl -X DELETE https://api.checklyhq.com/v1/variables/{key} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

DELETE /v1/variables/{key}

Permanently removes an environment variable. Uses the "key" field as the ID for deletion.

Parameters

Name In Type Description
key
(required)
path string none

Example responses

204 Response

"string"

Responses

Status Meaning Description Schema
204 No Content No Content string
401 Unauthorized Unauthorized Model_1

Retrieve an environment variable

Code samples

curl -X GET https://api.checklyhq.com/v1/variables/{key} \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

GET /v1/variables/{key}

Show details of a specific environment variable. Uses the "key" field for selection.

Parameters

Name In Type Description
key
(required)
path string none

Example responses

200 Response

{
  "key": "string",
  "value": "",
  "locked": false
}

Responses

Status Meaning Description Schema
200 OK Successful EnvironmentVariable
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Update a environment variable

Code samples

curl -X PUT https://api.checklyhq.com/v1/variables/{key} \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -H 'Authorization: Bearer API_KEY'

PUT /v1/variables/{key}

Updates an environment variable. Uses the "key" field as the ID for updating. Only updates the value.

Body parameter

{
  "key": "string",
  "value": "",
  "locked": false
}

Parameters

Name In Type Description
key
(required)
path string none
body body EnvironmentVariable none

Example responses

200 Response

{
  "key": "string",
  "value": "",
  "locked": false
}

Responses

Status Meaning Description Schema
200 OK Successful EnvironmentVariable
401 Unauthorized Unauthorized Model_1
404 Not Found Not Found Model_1

Schemas

config

{}

Properties

None

SubscriptionSchema

{
  "id": 0,
  "checkId": "string",
  "activated": true
}

Properties

Name Type Description
id number none
checkId
(required)
string none
activated
(required)
boolean none

subscriptions

[
  {
    "id": 0,
    "checkId": "string",
    "activated": true
  }
]

All checks subscribed to this channel.

Properties

Name Type Description
anonymous [SubscriptionSchema] All checks subscribed to this channel.

AlertChannel

{
  "id": 0,
  "type": "string",
  "config": {},
  "subscriptions": [
    {
      "id": 0,
      "checkId": "string",
      "activated": true
    }
  ],
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
id number none
type string The type of alert channel, i.e. EMAIL or SLACK.
config config none
subscriptions subscriptions All checks subscribed to this channel.
created_at string(date) none
updated_at string(date) none

AlertChannelsList

[
  {
    "id": 0,
    "type": "string",
    "config": {},
    "subscriptions": [
      {
        "id": 0,
        "checkId": "string",
        "activated": true
      }
    ],
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [AlertChannel] none

tags

[
  "string"
]

Properties

None

locations

[
  "string"
]

Properties

None

KeyValue

{
  "key": "string",
  "value": "",
  "locked": false
}

Properties

Name Type Description
key
(required)
string none
value
(required)
string none
locked boolean none

Headers

[]

Properties

Name Type Description
anonymous [KeyValue] none

QueryParameters

[]

Properties

Name Type Description
anonymous [KeyValue] none

Assertions

{
  "source": "STATUS_CODE",
  "property": "",
  "comparison": "EQUALS",
  "target": ""
}

Properties

Name Type Description
source string none
property string none
comparison string none
target string none

Enumerated Values

Property Value
source STATUS_CODE
source JSON_BODY
source HEADERS
source TEXT_BODY
source RESPONSE_TIME
comparison EQUALS
comparison NOT_EQUALS
comparison HAS_KEY
comparison NOT_HAS_KEY
comparison HAS_VALUE
comparison NOT_HAS_VALUE
comparison IS_EMPTY
comparison NOT_EMPTY
comparison GREATER_THAN
comparison LESS_THAN
comparison CONTAINS
comparison NOT_CONTAINS
comparison IS_NULL
comparison NOT_NULL

assertions

[]

Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.

Properties

Name Type Description
anonymous [Assertions] Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.

basicAuth

{
  "username": "",
  "password": ""
}

Properties

Name Type Description
username
(required)
string none
password
(required)
string none

apiCheckDefaults

{
  "url": "",
  "headers": [],
  "queryParameters": [],
  "assertions": [],
  "basicAuth": {
    "username": "",
    "password": ""
  }
}

Properties

Name Type Description
url string The base url for this group which you can reference with the {{GROUP_BASE_URL}} variable in all group checks.
headers Headers none
queryParameters QueryParameters none
assertions assertions Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.
basicAuth basicAuth none

browserCheckDefaults

{}

Properties

None

EnvironmentVariable

{
  "key": "string",
  "value": "",
  "locked": false
}

Properties

Name Type Description
key
(required)
string none
value
(required)
string none
locked boolean Used only in the UI to hide the value like a password

environmentVariables

[
  {
    "key": "string",
    "value": "",
    "locked": false
  }
]

Properties

Name Type Description
anonymous [EnvironmentVariable] none

runBasedEscalation

{
  "failedRunThreshold": 1
}

Properties

Name Type Description
failedRunThreshold number After how many failed consecutive check runs an alert notification should be send

Enumerated Values

Property Value
failedRunThreshold 1
failedRunThreshold 2
failedRunThreshold 3
failedRunThreshold 4
failedRunThreshold 5

timeBasedEscalation

{
  "minutesFailingThreshold": 5
}

Properties

Name Type Description
minutesFailingThreshold number After how many minutes after a check starts failing an alert should be send

Enumerated Values

Property Value
minutesFailingThreshold 5
minutesFailingThreshold 10
minutesFailingThreshold 15
minutesFailingThreshold 30

reminders

{
  "amount": 0,
  "interval": 5
}

Properties

Name Type Description
amount number How many reminders to send out after the initial alert notification
interval number At what interval the reminders should be send

Enumerated Values

Property Value
amount 0
amount 1
amount 2
amount 3
amount 4
amount 5
amount 100000
interval 5
interval 10
interval 15
interval 30

sslCertificates

{
  "enabled": true,
  "alertThreshold": 30
}

Properties

Name Type Description
enabled boolean Determines if alert notifications should be send for expiring SSL certificates
alertThreshold number At what moment in time to start alerting on SSL certificates

Enumerated Values

Property Value
alertThreshold 3
alertThreshold 7
alertThreshold 14
alertThreshold 30

AlertSettingsSchema

{
  "escalationType": "RUN_BASED",
  "runBasedEscalation": {
    "failedRunThreshold": 1
  },
  "timeBasedEscalation": {
    "minutesFailingThreshold": 5
  },
  "reminders": {
    "amount": 0,
    "interval": 5
  },
  "sslCertificates": {
    "enabled": false,
    "alertThreshold": 30
  }
}

Properties

Name Type Description
escalationType string Determines what type of escalation to use
runBasedEscalation runBasedEscalation none
timeBasedEscalation timeBasedEscalation none
reminders reminders none
sslCertificates sslCertificates none

Enumerated Values

Property Value
escalationType RUN_BASED
escalationType TIME_BASED

AlertChannelSubscription

{
  "alertChannelId": 0,
  "activated": true
}

Properties

Name Type Description
alertChannelId
(required)
number none
activated
(required)
boolean none

alertChannelSubscriptions

[
  {
    "alertChannelId": 0,
    "activated": true
  }
]

Properties

Name Type Description
anonymous [AlertChannelSubscription] none

CheckGroupList

[
  {
    "id": 0,
    "name": "string",
    "activated": true,
    "muted": true,
    "tags": [
      "string"
    ],
    "locations": [
      "string"
    ],
    "concurrency": 3,
    "apiCheckDefaults": {
      "url": "",
      "headers": [],
      "queryParameters": [],
      "assertions": [],
      "basicAuth": {
        "username": "",
        "password": ""
      }
    },
    "browserCheckDefaults": {},
    "environmentVariables": [
      {
        "key": "string",
        "value": "",
        "locked": false
      }
    ],
    "doubleCheck": true,
    "useGlobalAlertSettings": true,
    "alertSettings": {
      "escalationType": "RUN_BASED",
      "runBasedEscalation": {
        "failedRunThreshold": 1
      },
      "timeBasedEscalation": {
        "minutesFailingThreshold": 5
      },
      "reminders": {
        "amount": 0,
        "interval": 5
      },
      "sslCertificates": {
        "enabled": false,
        "alertThreshold": 30
      }
    },
    "alertChannelSubscriptions": [
      {
        "alertChannelId": 0,
        "activated": true
      }
    ],
    "setupSnippetId": 0,
    "tearDownSnippetId": 0,
    "localSetupScript": "string",
    "localTearDownScript": "string",
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [Model_2] none

Tags

[
  "string"
]

Tags for organizing and filtering checks

Properties

None

Locations

[
  "us-east-1"
]

An array of one or more data center locations where to run the checks

Properties

None

request

{
  "method": "GET",
  "url": "localhost",
  "followRedirects": true,
  "body": "",
  "bodyType": "NONE",
  "headers": [],
  "queryParameters": [],
  "assertions": [],
  "basicAuth": {
    "username": "",
    "password": ""
  }
}

Properties

Name Type Description
method
(required)
string none
url
(required)
string none
followRedirects boolean none
body string none
bodyType string none
headers Headers none
queryParameters QueryParameters none
assertions assertions Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.
basicAuth basicAuth none

Enumerated Values

Property Value
method GET
method POST
method PUT
method HEAD
method DELETE
method PATCH
bodyType NONE
bodyType JSON
bodyType FORM
bodyType RAW
bodyType GRAPHQL

EnvironmentVariables

[
  {
    "key": "string",
    "value": "",
    "locked": false
  }
]

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

Properties

Name Type Description
anonymous [EnvironmentVariable] Key/value pairs for setting environment variables during check execution. These are only relevant for Browser checks. Use global environment variables whenever possible.

AlertEmail

{
  "address": ""
}

Properties

Name Type Description
address
(required)
string none

email

[
  {
    "address": ""
  }
]

Properties

Name Type Description
anonymous [AlertEmail] none

AlertWebhook

{
  "name": "",
  "url": "",
  "method": "POST",
  "headers": [],
  "queryParameters": []
}

Properties

Name Type Description
name string none
url
(required)
string none
method string none
headers Headers none
queryParameters QueryParameters none

Enumerated Values

Property Value
method GET
method POST
method PUT
method HEAD
method DELETE
method PATCH

webhook

[
  {
    "name": "",
    "url": "",
    "method": "POST",
    "headers": [],
    "queryParameters": []
  }
]

Properties

Name Type Description
anonymous [AlertWebhook] none

AlertSlack

{
  "url": ""
}

Properties

Name Type Description
url
(required)
string none

slack

[
  {
    "url": ""
  }
]

Properties

Name Type Description
anonymous [AlertSlack] none

AlertSms

{
  "number": "",
  "name": "string"
}

Properties

Name Type Description
number
(required)
string none
name
(required)
string none

sms

[
  {
    "number": "",
    "name": "string"
  }
]

Properties

Name Type Description
anonymous [AlertSms] none

AlertChannels

{
  "email": [
    {
      "address": ""
    }
  ],
  "webhook": [
    {
      "name": "",
      "url": "",
      "method": "POST",
      "headers": [],
      "queryParameters": []
    }
  ],
  "slack": [
    {
      "url": ""
    }
  ],
  "sms": [
    {
      "number": "",
      "name": "string"
    }
  ]
}

Properties

Name Type Description
email email none
webhook webhook none
slack slack none
sms sms none

CheckGroupCheck

{
  "id": "string",
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0,
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "alertChannels": {
    "email": [
      {
        "address": ""
      }
    ],
    "webhook": [
      {
        "name": "",
        "url": "",
        "method": "POST",
        "headers": [],
        "queryParameters": []
      }
    ],
    "slack": [
      {
        "url": ""
      }
    ],
    "sms": [
      {
        "number": "",
        "name": "string"
      }
    ]
  },
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
id string none
name
(required)
string The name of the check
checkType
(required)
string The type of the check
frequency number none
activated
(required)
boolean Determines if the check is running or not
muted boolean Determines if any notifications will be send out when a check fails and/or recovers
doubleCheck boolean Setting this to "true" will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed
sslCheck boolean Determines if the SSL certificate should be validated for expiry
shouldFail boolean Allows to invert the behaviour of when a check is considered to fail. Allows for validating error status like 404
locations Model_6 An array of one or more data center locations where to run the this check
request request none
script string A valid piece of Node.js javascript code describing a browser interaction with the Puppeteer or Playwright frameworks.
environmentVariables EnvironmentVariables Key/value pairs for setting environment variables during check execution. These are only relevant for Browser checks. Use global environment variables whenever possible.
tags Tags Tags for organizing and filtering checks
setupSnippetId number An ID reference to a snippet to use in the setup phase of an API check
tearDownSnippetId number An ID reference to a snippet to use in the teardown phase of an API check
localSetupScript string A valid piece of Node.js code to run in the setup phase
localTearDownScript string A valid piece of Node.js code to run in the teardown phase
alertSettings Model_7 none
useGlobalAlertSettings boolean When true, the account level alert setting will be used, not the alert setting defined on this check
degradedResponseTime number The response time in milliseconds where a check should be considered degraded
maxResponseTime number The response time in milliseconds where a check should be considered failing
groupId number The id of the check group this check is part of
groupOrder number 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
alertChannelSubscriptions alertChannelSubscriptions none
alertChannels AlertChannels none
created_at string(date) none
updated_at string(date) none

Enumerated Values

Property Value
checkType BROWSER
checkType API
frequency 5
frequency 10
frequency 15
frequency 30
frequency 60
frequency 720
frequency 1440

Check

{
  "id": "string",
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0,
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "alertChannels": {
    "email": [
      {
        "address": ""
      }
    ],
    "webhook": [
      {
        "name": "",
        "url": "",
        "method": "POST",
        "headers": [],
        "queryParameters": []
      }
    ],
    "slack": [
      {
        "url": ""
      }
    ],
    "sms": [
      {
        "number": "",
        "name": "string"
      }
    ]
  },
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
id string none
name
(required)
string The name of the check
checkType
(required)
string The type of the check
frequency number none
activated
(required)
boolean Determines if the check is running or not
muted boolean Determines if any notifications will be send out when a check fails and/or recovers
doubleCheck boolean Setting this to "true" will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed
sslCheck boolean Determines if the SSL certificate should be validated for expiry
shouldFail boolean Allows to invert the behaviour of when a check is considered to fail. Allows for validating error status like 404
locations Model_10 An array of one or more data center locations where to run the this check
request request none
script string A valid piece of Node.js javascript code describing a browser interaction with the Puppeteer or Playwright frameworks.
environmentVariables EnvironmentVariables Key/value pairs for setting environment variables during check execution. These are only relevant for Browser checks. Use global environment variables whenever possible.
tags Tags Tags for organizing and filtering checks
setupSnippetId number An ID reference to a snippet to use in the setup phase of an API check
tearDownSnippetId number An ID reference to a snippet to use in the teardown phase of an API check
localSetupScript string A valid piece of Node.js code to run in the setup phase
localTearDownScript string A valid piece of Node.js code to run in the teardown phase
alertSettings Model_7 none
useGlobalAlertSettings boolean When true, the account level alert setting will be used, not the alert setting defined on this check
degradedResponseTime number The response time in milliseconds where a check should be considered degraded
maxResponseTime number The response time in milliseconds where a check should be considered failing
groupId number The id of the check group this check is part of
groupOrder number 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
alertChannelSubscriptions alertChannelSubscriptions none
alertChannels AlertChannels none
created_at string(date) none
updated_at string(date) none

Enumerated Values

Property Value
checkType BROWSER
checkType API
frequency 5
frequency 10
frequency 15
frequency 30
frequency 60
frequency 720
frequency 1440

CheckGroupChecksList

[
  {
    "id": "string",
    "name": "string",
    "checkType": "BROWSER",
    "frequency": 5,
    "activated": true,
    "muted": false,
    "doubleCheck": true,
    "sslCheck": true,
    "shouldFail": true,
    "locations": [
      "us-east-1"
    ],
    "request": {
      "method": "GET",
      "url": "localhost",
      "followRedirects": true,
      "body": "",
      "bodyType": "NONE",
      "headers": [],
      "queryParameters": [],
      "assertions": [],
      "basicAuth": {
        "username": "",
        "password": ""
      }
    },
    "script": "string",
    "environmentVariables": [
      {
        "key": "string",
        "value": "",
        "locked": false
      }
    ],
    "tags": [
      "string"
    ],
    "setupSnippetId": 0,
    "tearDownSnippetId": 0,
    "localSetupScript": "string",
    "localTearDownScript": "string",
    "alertSettings": {
      "escalationType": "RUN_BASED",
      "runBasedEscalation": {
        "failedRunThreshold": 1
      },
      "timeBasedEscalation": {
        "minutesFailingThreshold": 5
      },
      "reminders": {
        "amount": 0,
        "interval": 5
      },
      "sslCertificates": {
        "enabled": false,
        "alertThreshold": 30
      }
    },
    "useGlobalAlertSettings": true,
    "degradedResponseTime": 10000,
    "maxResponseTime": 20000,
    "groupId": 0,
    "groupOrder": 0,
    "alertChannelSubscriptions": [
      {
        "alertChannelId": 0,
        "activated": true
      }
    ],
    "alertChannels": {
      "email": [
        {
          "address": ""
        }
      ],
      "webhook": [
        {
          "name": "",
          "url": "",
          "method": "POST",
          "headers": [],
          "queryParameters": []
        }
      ],
      "slack": [
        {
          "url": ""
        }
      ],
      "sms": [
        {
          "number": "",
          "name": "string"
        }
      ]
    },
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [Check] none

responseTimes

[
  "string"
]

Properties

None

RolledUpCheckResult

{
  "checkId": "string",
  "runLocation": "string",
  "errorCount": 0,
  "failureCount": 0,
  "resultsCount": 0,
  "hour": "2019-08-24",
  "responseTimes": [
    "string"
  ]
}

Properties

Name Type Description
checkId string none
runLocation string What data center location this set of check results originated from
errorCount number The total amount of errored out check results for this hour. This value should be 0 in almost all cases as it records failures in the Checkly backend.
failureCount number The total amount of failed check results for this hour.
resultsCount number The total amount of results recorded for this hour. Depends on how often this check is scheduled to run.
hour string(date) All results per time unit / per location are rolled up to a specific hour
responseTimes responseTimes none

RolledUpCheckResultsList

[
  {
    "checkId": "string",
    "runLocation": "string",
    "errorCount": 0,
    "failureCount": 0,
    "resultsCount": 0,
    "hour": "2019-08-24",
    "responseTimes": [
      "string"
    ]
  }
]

Properties

Name Type Description
anonymous [RolledUpCheckResult] none

apiCheckResult

{}

Properties

None

browserCheckResult

{}

Properties

None

CheckResult

{
  "id": "string",
  "name": "string",
  "checkId": "string",
  "hasFailures": true,
  "hasErrors": true,
  "isDegraded": true,
  "overMaxResponseTime": true,
  "runLocation": "string",
  "startedAt": "2019-08-24",
  "stoppedAt": "2019-08-24",
  "created_at": "2019-08-24",
  "responseTime": 0,
  "apiCheckResult": {},
  "browserCheckResult": {},
  "checkRunId": 0,
  "attempts": 0
}

Properties

Name Type Description
id string The unique ID of this result
name string The name of the check
checkId string The ID of the check
hasFailures boolean Describes if any failure has occurred during this check run. This is should be your mainmain focus for assessing API or browser check behaviour. Assertions that fail, timeouts or failing scripts all resolve tothis value being true
hasErrors boolean Describes if an internal error has occured in Checkly's backend. This should be false in almost all cases.
isDegraded boolean A check is degraded if it is over the degradation limit set by the "degradedResponseTime" field on the check. Applies only to API checks.
overMaxResponseTime boolean Set to true if the response time is over the limit set by the "maxResponseTime" field on the check. Applies only to API checks.
runLocation string What data center location this check result originated from
startedAt string(date) none
stoppedAt string(date) none
created_at string(date) none
responseTime number Describes the time it took to execute relevant parts of this check. Any setup timeor system time needed to start executing this check in the Checkly backend is not part of this.
apiCheckResult apiCheckResult none
browserCheckResult browserCheckResult none
checkRunId number The id of the specific check run that created this check result
attempts number How often this check was retried. This will be larger than 0 when double checking is enabled

CheckResultsList

[
  {
    "id": "string",
    "name": "string",
    "checkId": "string",
    "hasFailures": true,
    "hasErrors": true,
    "isDegraded": true,
    "overMaxResponseTime": true,
    "runLocation": "string",
    "startedAt": "2019-08-24",
    "stoppedAt": "2019-08-24",
    "created_at": "2019-08-24",
    "responseTime": 0,
    "apiCheckResult": {},
    "browserCheckResult": {},
    "checkRunId": 0,
    "attempts": 0
  }
]

Properties

Name Type Description
anonymous [CheckResult] none

CheckStatus

{
  "checkId": "string",
  "hasFailures": true,
  "hasErrors": true,
  "isDegraded": true,
  "longestRun": 0,
  "shortestRun": 0,
  "lastRunLocation": "string",
  "lastCheckRunId": "string",
  "sslDaysRemaining": 0,
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
checkId string The ID of check this status belongs to
hasFailures boolean Describes if this check is currently failing. If any of the assertions for an API checkfail this value is true. If a browser check fails for whatever reason, this is true
hasErrors boolean Describes if due to some error outside of normal operation this check is failing. This should be extremely rare and only when there is an error in the Checkly backend
isDegraded boolean A check is degraded if it is over the degradation limit set by the "degradedResponseTime" field on the check. Applies only to API checks.
longestRun number The longest ever recorded response time for this check
shortestRun number The shortest ever recorded response time for this check
lastRunLocation string What location this check was last run at
lastCheckRunId string The unique incrementing ID for each check run
sslDaysRemaining number How many days remain till the current SSL certificate expires
created_at string(date) none
updated_at string(date) none

CheckStatusList

[
  {
    "checkId": "string",
    "hasFailures": true,
    "hasErrors": true,
    "isDegraded": true,
    "longestRun": 0,
    "shortestRun": 0,
    "lastRunLocation": "string",
    "lastCheckRunId": "string",
    "sslDaysRemaining": 0,
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [CheckStatus] none

CheckList

[
  {
    "id": "string",
    "name": "string",
    "checkType": "BROWSER",
    "frequency": 5,
    "activated": true,
    "muted": false,
    "doubleCheck": true,
    "sslCheck": true,
    "shouldFail": true,
    "locations": [
      "us-east-1"
    ],
    "request": {
      "method": "GET",
      "url": "localhost",
      "followRedirects": true,
      "body": "",
      "bodyType": "NONE",
      "headers": [],
      "queryParameters": [],
      "assertions": [],
      "basicAuth": {
        "username": "",
        "password": ""
      }
    },
    "script": "string",
    "environmentVariables": [
      {
        "key": "string",
        "value": "",
        "locked": false
      }
    ],
    "tags": [
      "string"
    ],
    "setupSnippetId": 0,
    "tearDownSnippetId": 0,
    "localSetupScript": "string",
    "localTearDownScript": "string",
    "alertSettings": {
      "escalationType": "RUN_BASED",
      "runBasedEscalation": {
        "failedRunThreshold": 1
      },
      "timeBasedEscalation": {
        "minutesFailingThreshold": 5
      },
      "reminders": {
        "amount": 0,
        "interval": 5
      },
      "sslCertificates": {
        "enabled": false,
        "alertThreshold": 30
      }
    },
    "useGlobalAlertSettings": true,
    "degradedResponseTime": 10000,
    "maxResponseTime": 20000,
    "groupId": 0,
    "groupOrder": 0,
    "alertChannelSubscriptions": [
      {
        "alertChannelId": 0,
        "activated": true
      }
    ],
    "alertChannels": {
      "email": [
        {
          "address": ""
        }
      ],
      "webhook": [
        {
          "name": "",
          "url": "",
          "method": "POST",
          "headers": [],
          "queryParameters": []
        }
      ],
      "slack": [
        {
          "url": ""
        }
      ],
      "sms": [
        {
          "number": "",
          "name": "string"
        }
      ]
    },
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [Check] none

CheckCreate

{
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0
}

Properties

Name Type Description
name
(required)
string The name of the check
checkType
(required)
string The type of the check
frequency number none
activated
(required)
boolean Determines if the check is running or not
muted boolean Determines if any notifications will be send out when a check fails and/or recovers
doubleCheck boolean Setting this to "true" will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed
sslCheck boolean Determines if the SSL certificate should be validated for expiry
shouldFail boolean Allows to invert the behaviour of when a check is considered to fail. Allows for validating error status like 404
locations Model_11 An array of one or more data center locations where to run the this check
request request none
script string A valid piece of Node.js javascript code describing a browser interaction with the Puppeteer or Playwright frameworks.
environmentVariables EnvironmentVariables Key/value pairs for setting environment variables during check execution. These are only relevant for Browser checks. Use global environment variables whenever possible.
tags Tags Tags for organizing and filtering checks
setupSnippetId number An ID reference to a snippet to use in the setup phase of an API check
tearDownSnippetId number An ID reference to a snippet to use in the teardown phase of an API check
localSetupScript string A valid piece of Node.js code to run in the setup phase
localTearDownScript string A valid piece of Node.js code to run in the teardown phase
alertSettings Model_7 none
useGlobalAlertSettings boolean When true, the account level alert setting will be used, not the alert setting defined on this check
degradedResponseTime number The response time in milliseconds where a check should be considered degraded
maxResponseTime number The response time in milliseconds where a check should be considered failing
groupId number The id of the check group this check is part of
groupOrder number 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

Enumerated Values

Property Value
checkType BROWSER
checkType API
frequency 5
frequency 10
frequency 15
frequency 30
frequency 60
frequency 720
frequency 1440

DashboardResponse

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false,
  "dashboardId": "string"
}

Properties

Name Type Description
customUrl
(required)
string A subdomain name under "checklyhq.com". Needs to be unique across all users.
customDomain
(required)
string A custom user domain, e.g. "status.example.com". See the docs on updating your DNS and SSL usage.
logo
(required)
string A URL pointing to an image file.
header
(required)
string A piece of text displayed at the top of your dashboard.
width string Determines whether to use the full screen or focus in the center.
refreshRate
(required)
number How often to refresh the dashboard in seconds.
paginate
(required)
boolean Determines of pagination is on or off.
paginationRate
(required)
number How often to trigger pagination in seconds.
tags Model_15 A list of one or more tags that filter which checks to display on the dashboard.
hideTags
(required)
boolean Show or hide the tags on the dashboard.
dashboardId
(required)
string none

Enumerated Values

Property Value
width FULL
width 960PX
refreshRate 60
refreshRate 300
refreshRate 600
paginationRate 30
paginationRate 60
paginationRate 300

DashboardsList

[
  {
    "customUrl": "string",
    "customDomain": "string",
    "logo": "string",
    "header": "string",
    "width": "FULL",
    "refreshRate": 60,
    "paginate": true,
    "paginationRate": 30,
    "tags": [
      "string"
    ],
    "hideTags": false,
    "dashboardId": "string"
  }
]

Properties

Name Type Description
anonymous [DashboardResponse] none

DashboardSchema

{
  "customUrl": "string",
  "customDomain": "string",
  "logo": "string",
  "header": "string",
  "width": "FULL",
  "refreshRate": 60,
  "paginate": true,
  "paginationRate": 30,
  "tags": [
    "string"
  ],
  "hideTags": false
}

Properties

Name Type Description
customUrl
(required)
string A subdomain name under "checklyhq.com". Needs to be unique across all users.
customDomain
(required)
string A custom user domain, e.g. "status.example.com". See the docs on updating your DNS and SSL usage.
logo
(required)
string A URL pointing to an image file.
header
(required)
string A piece of text displayed at the top of your dashboard.
width string Determines whether to use the full screen or focus in the center.
refreshRate
(required)
number How often to refresh the dashboard in seconds.
paginate
(required)
boolean Determines of pagination is on or off.
paginationRate
(required)
number How often to trigger pagination in seconds.
tags Model_16 A list of one or more tags that filter which checks to display on the dashboard.
hideTags
(required)
boolean Show or hide the tags on the dashboard.

Enumerated Values

Property Value
width FULL
width 960PX
refreshRate 60
refreshRate 300
refreshRate 600
paginationRate 30
paginationRate 60
paginationRate 300

MaintenanceWindowsList

[
  {
    "id": 0,
    "name": "string",
    "tags": [
      "string"
    ],
    "startsAt": "2019-08-24",
    "endsAt": "2019-08-24",
    "repeatInterval": 1,
    "repeatUnit": "DAY",
    "repeatEndsAt": "2019-08-24",
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [Model_18] none

Snippet

{
  "id": 0,
  "name": "string",
  "script": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
id number none
name string The snippet name
script string Your Node.js code that interacts with the API check lifecycle, or functions as a partial for browser checks.
created_at string(date) none
updated_at string(date) none

SnippetsList

[
  {
    "id": 0,
    "name": "string",
    "script": "string",
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

Properties

Name Type Description
anonymous [Snippet] none

SnippetCreate

{
  "name": "string",
  "script": "string"
}

Properties

Name Type Description
name
(required)
string The snippet name
script
(required)
string Your Node.js code that interacts with the API check lifecycle, or functions as a partial for browser checks.

EnvironmentVariablesList

[
  {
    "key": "string",
    "value": "",
    "locked": false
  }
]

Properties

Name Type Description
anonymous [EnvironmentVariable] none

Model_1

{}

Properties

None

Model_2

{
  "id": 0,
  "name": "string",
  "activated": true,
  "muted": true,
  "tags": [
    "string"
  ],
  "locations": [
    "string"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {
    "url": "",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
id number none
name
(required)
string none
activated
(required)
boolean none
muted boolean none
tags tags none
locations locations none
concurrency
(required)
number none
apiCheckDefaults
(required)
apiCheckDefaults none
browserCheckDefaults
(required)
browserCheckDefaults none
environmentVariables environmentVariables none
doubleCheck boolean none
useGlobalAlertSettings boolean none
alertSettings AlertSettingsSchema none
alertChannelSubscriptions alertChannelSubscriptions none
setupSnippetId number none
tearDownSnippetId number none
localSetupScript string none
localTearDownScript string none
created_at string(date) none
updated_at string(date) none

Model_3

{}

Properties

Name Type Description
url string The base url for this group which you can reference with the {{GROUP_BASE_URL}} variable in all group checks.
headers Headers none
queryParameters QueryParameters none
assertions assertions Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.
basicAuth basicAuth none

Model_4

{}

Properties

None

Model_5

{
  "name": "string",
  "activated": true,
  "muted": false,
  "tags": [
    "string"
  ],
  "locations": [
    "us-east-1"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {},
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string"
}

Properties

Name Type Description
name
(required)
string The name of the check group
activated boolean Determines if the checks in the group are running or not
muted boolean Determines if any notifications will be send out when a check in this group fails and/or recovers
tags Tags Tags for organizing and filtering checks
locations
(required)
Locations An array of one or more data center locations where to run the checks
concurrency number Determines how many checks are invoked concurrently when triggering a check group from CI/CD or through the API.
apiCheckDefaults Model_3 none
browserCheckDefaults Model_4 none
environmentVariables environmentVariables none
doubleCheck boolean Setting this to "true" will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed
useGlobalAlertSettings boolean When true, the account level alert setting will be used, not the alert setting defined on this check group
alertSettings AlertSettingsSchema none
alertChannelSubscriptions alertChannelSubscriptions none
setupSnippetId number An ID reference to a snippet to use in the setup phase of an API check in this group
tearDownSnippetId number An ID reference to a snippet to use in the teardown phase of an API check in this group
localSetupScript string A valid piece of Node.js code to run in the setup phase of an API check in this group
localTearDownScript string A valid piece of Node.js code to run in the teardown phase of an API check in this group

Model_6

[
  "us-east-1"
]

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

Properties

None

Model_7

{
  "escalationType": "RUN_BASED",
  "runBasedEscalation": {
    "failedRunThreshold": 1
  },
  "timeBasedEscalation": {
    "minutesFailingThreshold": 5
  },
  "reminders": {
    "amount": 0,
    "interval": 5
  },
  "sslCertificates": {
    "enabled": false,
    "alertThreshold": 30
  }
}

Properties

Name Type Description
escalationType string Determines what type of escalation to use
runBasedEscalation runBasedEscalation none
timeBasedEscalation timeBasedEscalation none
reminders reminders none
sslCertificates sslCertificates none

Enumerated Values

Property Value
escalationType RUN_BASED
escalationType TIME_BASED

Model_8

{}

Properties

Name Type Description
url string The base url for this group which you can reference with the {{GROUP_BASE_URL}} variable in all group checks.
headers Headers none
queryParameters QueryParameters none
assertions assertions Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.
basicAuth basicAuth none

Model_9

{
  "name": "string",
  "activated": true,
  "muted": false,
  "tags": [
    "string"
  ],
  "locations": [
    "us-east-1"
  ],
  "concurrency": 3,
  "apiCheckDefaults": {},
  "browserCheckDefaults": {},
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "doubleCheck": true,
  "useGlobalAlertSettings": true,
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "alertChannelSubscriptions": [
    {
      "alertChannelId": 0,
      "activated": true
    }
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string"
}

Properties

Name Type Description
name string The name of the check group
activated boolean Determines if the checks in the group are running or not
muted boolean Determines if any notifications will be send out when a check in this group fails and/or recovers
tags Tags Tags for organizing and filtering checks
locations Locations An array of one or more data center locations where to run the checks
concurrency number Determines how many checks are invoked concurrently when triggering a check group from CI/CD or through the API.
apiCheckDefaults Model_8 none
browserCheckDefaults Model_4 none
environmentVariables environmentVariables none
doubleCheck boolean Setting this to "true" will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed
useGlobalAlertSettings boolean When true, the account level alert setting will be used, not the alert setting defined on this check group
alertSettings AlertSettingsSchema none
alertChannelSubscriptions alertChannelSubscriptions none
setupSnippetId number An ID reference to a snippet to use in the setup phase of an API check in this group
tearDownSnippetId number An ID reference to a snippet to use in the teardown phase of an API check in this group
localSetupScript string A valid piece of Node.js code to run in the setup phase of an API check in this group
localTearDownScript string A valid piece of Node.js code to run in the teardown phase of an API check in this group

Model_10

[
  "us-east-1"
]

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

Properties

None

Model_11

[
  "us-east-1"
]

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

Properties

None

Model_12

[
  "us-east-1"
]

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

Properties

None

Model_13

{
  "escalationType": "RUN_BASED",
  "runBasedEscalation": {
    "failedRunThreshold": 1
  },
  "timeBasedEscalation": {
    "minutesFailingThreshold": 5
  },
  "reminders": {
    "amount": 0,
    "interval": 5
  },
  "sslCertificates": {
    "enabled": false,
    "alertThreshold": 30
  }
}

Properties

Name Type Description
escalationType string Determines what type of escalation to use
runBasedEscalation runBasedEscalation none
timeBasedEscalation timeBasedEscalation none
reminders reminders none
sslCertificates sslCertificates none

Enumerated Values

Property Value
escalationType RUN_BASED
escalationType TIME_BASED

Model_14

{
  "name": "string",
  "checkType": "BROWSER",
  "frequency": 5,
  "activated": true,
  "muted": false,
  "doubleCheck": true,
  "sslCheck": true,
  "shouldFail": true,
  "locations": [
    "us-east-1"
  ],
  "request": {
    "method": "GET",
    "url": "localhost",
    "followRedirects": true,
    "body": "",
    "bodyType": "NONE",
    "headers": [],
    "queryParameters": [],
    "assertions": [],
    "basicAuth": {
      "username": "",
      "password": ""
    }
  },
  "script": "string",
  "environmentVariables": [
    {
      "key": "string",
      "value": "",
      "locked": false
    }
  ],
  "tags": [
    "string"
  ],
  "setupSnippetId": 0,
  "tearDownSnippetId": 0,
  "localSetupScript": "string",
  "localTearDownScript": "string",
  "alertSettings": {
    "escalationType": "RUN_BASED",
    "runBasedEscalation": {
      "failedRunThreshold": 1
    },
    "timeBasedEscalation": {
      "minutesFailingThreshold": 5
    },
    "reminders": {
      "amount": 0,
      "interval": 5
    },
    "sslCertificates": {
      "enabled": false,
      "alertThreshold": 30
    }
  },
  "useGlobalAlertSettings": true,
  "degradedResponseTime": 10000,
  "maxResponseTime": 20000,
  "groupId": 0,
  "groupOrder": 0
}

Properties

Name Type Description
name string The name of the check
checkType string The type of the check
frequency number none
activated boolean Determines if the check is running or not
muted boolean Determines if any notifications will be send out when a check fails and/or recovers
doubleCheck boolean Setting this to "true" will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed
sslCheck boolean Determines if the SSL certificate should be validated for expiry
shouldFail boolean Allows to invert the behaviour of when a check is considered to fail. Allows for validating error status like 404
locations Model_12 An array of one or more data center locations where to run the this check
request request none
script string A valid piece of Node.js javascript code describing a browser interaction with the Puppeteer or Playwright frameworks.
environmentVariables EnvironmentVariables Key/value pairs for setting environment variables during check execution. These are only relevant for Browser checks. Use global environment variables whenever possible.
tags Tags Tags for organizing and filtering checks
setupSnippetId number An ID reference to a snippet to use in the setup phase of an API check
tearDownSnippetId number An ID reference to a snippet to use in the teardown phase of an API check
localSetupScript string A valid piece of Node.js code to run in the setup phase
localTearDownScript string A valid piece of Node.js code to run in the teardown phase
alertSettings Model_13 none
useGlobalAlertSettings boolean When true, the account level alert setting will be used, not the alert setting defined on this check
degradedResponseTime number The response time in milliseconds where a check should be considered degraded
maxResponseTime number The response time in milliseconds where a check should be considered failing
groupId number The id of the check group this check is part of
groupOrder number 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

Enumerated Values

Property Value
checkType BROWSER
checkType API
frequency 5
frequency 10
frequency 15
frequency 30
frequency 60
frequency 720
frequency 1440

Model_15

[
  "string"
]

A list of one or more tags that filter which checks to display on the dashboard.

Properties

None

Model_16

[
  "string"
]

A list of one or more tags that filter which checks to display on the dashboard.

Properties

None

Model_17

[
  "string"
]

The names of the checks and groups maintenance window should apply to

Properties

None

Model_18

{
  "id": 0,
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24",
  "created_at": "2019-08-24",
  "updated_at": "2019-08-24"
}

Properties

Name Type Description
id
(required)
number The id of the maintenance window
name
(required)
string The maintenance window name
tags
(required)
Model_17 The names of the checks and groups maintenance window should apply to
startsAt
(required)
string(date) The start date of the maintenance window
endsAt
(required)
string(date) The end date of the maintenance window
repeatInterval number The repeat interval of the maintenance window from the first occurance
repeatUnit string none
repeatEndsAt string(date) The end date where the maintenance window should stop repeating
created_at
(required)
string(date) The creation date of the maintenance window
updated_at
(required)
string(date) The last date that the maintenance window was updated

Enumerated Values

Property Value
repeatUnit DAY
repeatUnit WEEK
repeatUnit MONTH

Model_19

[
  "string"
]

The names of the checks and groups maintenance window should apply to

Properties

None

Model_20

{
  "name": "string",
  "tags": [
    "string"
  ],
  "startsAt": "2019-08-24",
  "endsAt": "2019-08-24",
  "repeatInterval": 1,
  "repeatUnit": "DAY",
  "repeatEndsAt": "2019-08-24"
}

Properties

Name Type Description
name
(required)
string The maintenance window name
tags
(required)
Model_19 The names of the checks and groups maintenance window should apply to
startsAt
(required)
string(date) The start date of the maintenance window
endsAt
(required)
string(date) The end date of the maintenance window
repeatInterval number The repeat interval of the maintenance window from the first occurance
repeatUnit string none
repeatEndsAt string(date) The end date where the maintenance window should stop repeating

Enumerated Values

Property Value
repeatUnit DAY
repeatUnit WEEK
repeatUnit MONTH

schema1

{
  "key": "string",
  "value": "",
  "locked": false
}

Properties

Name Type Description
key
(required)
string none
value
(required)
string none
locked boolean none

schema2

{
  "source": "STATUS_CODE",
  "property": "",
  "comparison": "EQUALS",
  "target": ""
}

Properties

Name Type Description
source string none
property string none
comparison string none
target string none

Enumerated Values

Property Value
source STATUS_CODE
source JSON_BODY
source HEADERS
source TEXT_BODY
source RESPONSE_TIME
comparison EQUALS
comparison NOT_EQUALS
comparison HAS_KEY
comparison NOT_HAS_KEY
comparison HAS_VALUE
comparison NOT_HAS_VALUE
comparison IS_EMPTY
comparison NOT_EMPTY
comparison GREATER_THAN
comparison LESS_THAN
comparison CONTAINS
comparison NOT_CONTAINS
comparison IS_NULL
comparison NOT_NULL

schema3

[]

Properties

Name Type Description
anonymous [schema1] none

schema4

[]

Properties

Name Type Description
anonymous [schema1] none

schema5

[]

Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.

Properties

Name Type Description
anonymous [schema2] Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.

schema6

{
  "username": "",
  "password": ""
}

Properties

Name Type Description
username
(required)
string none
password
(required)
string none

schema7

{
  "method": "GET",
  "url": "localhost",
  "followRedirects": true,
  "body": "",
  "bodyType": "NONE",
  "headers": [],
  "queryParameters": [],
  "assertions": [],
  "basicAuth": {
    "username": "",
    "password": ""
  }
}

Properties

Name Type Description
method
(required)
string none
url
(required)
string none
followRedirects boolean none
body string none
bodyType string none
headers schema3 none
queryParameters schema4 none
assertions schema5 Check the main Checkly documentation on assertions for specific values like regular expressions and JSON path descriptors you can use in the "property" field.
basicAuth schema6 none

Enumerated Values

Property Value
method GET
method POST
method PUT
method HEAD
method DELETE
method PATCH
bodyType NONE
bodyType JSON
bodyType FORM
bodyType RAW
bodyType GRAPHQL

schema8

{}

Properties

None