---
title: "Changes to Create an SSL monitor"
method: POST
path: "/v1/checks/ssl"
---

# Changes to Create an SSL monitor

`POST /v1/checks/ssl`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-08-12** `87d29dc7b4fe` — 28 breaking, 4 warning, 86 info
- **2026-08-05** `9e903da4f3da` — 14 breaking, 5 warning, 21 info

## Changes

- **2026-08-12** `87d29dc7b4fe` — 28 breaking, 4 warning, 86 info
  - request body became required
  - for the `header` request parameter `x-checkly-account`, the type/format was changed from `string`/`` to `string`/`uuid`
  - the request property `request/sslConfig/serverName` became not nullable
  - the request property `request/assertions/items/comparison` became required
  - 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 `request/sslClientCertificateId` request property's minLength was increased from `0` to `1`
  - the `request/sslConfig/hostname` 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 `request/sslClientCertificateId` request property type/format changed from `string`/`` to `string`/`uuid`
  - the `request/sslConfig/serverName` request property type/format changed from `string`/`` to ``/``
  - the `triggerIncident/serviceId` request property type/format changed from `string`/`` to `string`/`uuid`
  - the response property `alertChannels/email/items/address` became optional for the status `201`
  - the response property `alertChannels/slack/items/url` became optional for the status `201`
  - the response property `alertChannels/sms/items/number` became optional for the status `201`
  - the response property `alertChannels/webhook/items/url` became optional for the status `201`
  - the response property `request/sslClientCertificateId` became optional for the status `201`
  - the `request/sslConfig/serverName` response property's maxLength was unset from `2048` for the response status `201`
  - the `created_at` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `201`
  - the `request/sslConfig/serverName` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - 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
  - added the new `undefined` enum value to the `runtimeId` response property for the response status `201`
  - added the new optional request property `checkType`
  - added `subschema #1, subschema #2, subschema #3` to the `request/sslConfig/serverName` request property `anyOf` list
  - the request property `environmentVariables/items/value` became nullable
  - the request property `heartbeat` became nullable
  - the request property `script` became nullable
  - the request property `sslCheckDomain` became nullable
  - the request property `heartbeat` became optional
  - the request property `request/sslClientCertificateId` became optional
  - …78 more
- **2026-08-05** `9e903da4f3da` — 14 breaking, 5 warning, 21 info
  - removed the enum value `CERT_EXPIRES_IN_DAYS` of the request property `request/assertions/items/source`
  - removed the enum value `CERT_FINGERPRINT_SHA256` of the request property `request/assertions/items/source`
  - removed the enum value `CERT_NOT_EXPIRED` of the request property `request/assertions/items/source`
  - removed the enum value `CHAIN_TRUSTED` of the request property `request/assertions/items/source`
  - removed the enum value `CIPHER_SUITE` of the request property `request/assertions/items/source`
  - removed the enum value `HANDSHAKE_TIME_MS` of the request property `request/assertions/items/source`
  - removed the enum value `HOSTNAME_VERIFIED` of the request property `request/assertions/items/source`
  - removed the enum value `ISSUER_CN` of the request property `request/assertions/items/source`
  - removed the enum value `ISSUER_FINGERPRINT_SHA256` of the request property `request/assertions/items/source`
  - removed the enum value `KEY_SIZE_BITS` of the request property `request/assertions/items/source`
  - removed the enum value `OCSP_STAPLED` of the request property `request/assertions/items/source`
  - removed the enum value `SAN_CONTAINS` of the request property `request/assertions/items/source`
  - removed the enum value `SIGNATURE_ALGORITHM` of the request property `request/assertions/items/source`
  - removed the enum value `TLS_VERSION` of the request property `request/assertions/items/source`
  - added the new `CERTIFICATE` enum value to the `request/assertions/items/source` response property for the response status `201`
  - added the new `CONNECTION` enum value to the `request/assertions/items/source` response property for the response status `201`
  - added the new `JSON_RESPONSE` enum value to the `request/assertions/items/source` response property for the response status `201`
  - added the new `RESPONSE_TIME` enum value to the `request/assertions/items/source` response property for the response status `201`
  - added the new `TEXT_RESPONSE` enum value to the `request/assertions/items/source` response property for the response status `201`
  - the `property` request property default value `` was removed
  - added the new `CERTIFICATE` enum value to the request property `request/assertions/items/source`
  - added the new `CONNECTION` enum value to the request property `request/assertions/items/source`
  - added the new `JSON_RESPONSE` enum value to the request property `request/assertions/items/source`
  - added the new `RESPONSE_TIME` enum value to the request property `request/assertions/items/source`
  - added the new `TEXT_RESPONSE` enum value to the request property `request/assertions/items/source`
  - the `property` response's property default value `` was removed for the status `201`
  - removed the `CERT_EXPIRES_IN_DAYS` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `CERT_FINGERPRINT_SHA256` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `CERT_NOT_EXPIRED` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `CHAIN_TRUSTED` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `CIPHER_SUITE` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `HANDSHAKE_TIME_MS` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `HOSTNAME_VERIFIED` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `ISSUER_CN` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `ISSUER_FINGERPRINT_SHA256` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `KEY_SIZE_BITS` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `OCSP_STAPLED` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `SAN_CONTAINS` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `SIGNATURE_ALGORITHM` enum value from the `request/assertions/items/source` response property for the response status `201`
  - removed the `TLS_VERSION` enum value from the `request/assertions/items/source` response property for the response status `201`

---

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