---
title: "Changes to Create a check"
method: POST
path: "/v1/checks"
---

# Changes to Create a check

`POST /v1/checks`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-08-12** `87d29dc7b4fe` — 21 breaking, 4 warning, 41 info

## Changes

- **2026-08-12** `87d29dc7b4fe` — 21 breaking, 4 warning, 41 info
  - request body became required
  - for the `header` request parameter `x-checkly-account`, the type/format was changed from `string`/`` to `string`/`uuid`
  - request property `frequency` was restricted to a list of enum values
  - the `dependencies/items/content` request property's minLength was increased from `0` to `1`
  - the `dependencies/items/path` request property's minLength was increased from `0` to `1`
  - the `environmentVariables/items/key` request property's minLength was increased from `0` to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - the `privateLocations/items/` request property's minLength was increased from `0` to `1`
  - the `scriptPath` request property's minLength was increased from `0` to `1`
  - the `tags/items/` request property's minLength was increased from `0` to `1`
  - the `triggerIncident/serviceId` request property's minLength was increased from `0` to `1`
  - the `alertSettings/parallelRunFailureThreshold/percentage` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/reminders/amount` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/reminders/interval` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/runBasedEscalation/failedRunThreshold` request property type/format changed from `number`/`` to `integer`/``
  - the `alertSettings/timeBasedEscalation/minutesFailingThreshold` request property type/format changed from `number`/`` to `integer`/``
  - the `degradedResponseTime` request property type/format changed from ``/`` to `number`/``
  - the `maxResponseTime` request property type/format changed from ``/`` to `number`/``
  - the `triggerIncident/serviceId` request property type/format changed from `string`/`` to `string`/`uuid`
  - the response's body type/format changed from `object`/`` to ``/`` for status `201`
  - removed the required property `checkType` from the response with the `201` status
  - removed the optional property `attributes` from the response with the `401` status
  - removed the optional property `attributes` from the response with the `402` status
  - removed the optional property `attributes` from the response with the `429` status
  - removed the optional property `id` from the response with the `201` status
  - the request property `degradedResponseTime` became nullable
  - the request property `environmentVariables/items/value` became nullable
  - the request property `heartbeat` became nullable
  - the request property `maxResponseTime` became nullable
  - the request property `script` became nullable
  - the request property `sslCheckDomain` became nullable
  - the request property `heartbeat` became optional
  - the request property `script` became optional
  - the `locations` request property default value `` was added
  - the `tags` request property default value `` was added
  - the `activated` request property default value `true` was removed
  - added the new `0.00` enum value to the request property `frequency`
  - added the new `1.00` enum value to the request property `frequency`
  - added the new `10.00` enum value to the request property `frequency`
  - added the new `120.00` enum value to the request property `frequency`
  - …26 more

---

[Operation](https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/checks/post.md) · [API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) · [Page](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/checks/post)