Sign in
Monitors

Update an SSL Monitor

Updates an SSL monitor.

put/v1/checks/ssl/{id}

Path parameters

idstring uuid required

Query parameters

autoAssignAlertsboolean

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

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

Headers

x-checkly-accountstring uuid

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

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

Request body

namestring
activatedboolean
mutedboolean
doubleCheckboolean
shouldFailboolean
locationsstring[] nullable
tagsstring[]
useGlobalAlertSettingsboolean
groupIdnumber nullable
groupOrdernumber nullable
runtimeId'2026.04' | '2025.04' | '2024.09' | '2024.02' | '2023.09' | '2023.02' | '2022.10' | 'null' nullable
runParallelboolean
descriptionstring nullable
checkType'SSL'
frequency0 | 1 | 2 | 5 | 10 | 15 | 30 | 60 | 120 | 180 | 360 | 720 | 1440
frequencyOffsetinteger
heartbeatobject nullable
scriptstring nullable
scriptPathstring nullable
sslCheckDomainstring nullable
setupSnippetIdnumber nullable
tearDownSnippetIdnumber nullable
localSetupScriptstring nullable
localTearDownScriptstring nullable
degradedResponseTimeinteger
maxResponseTimeinteger
privateLocationsstring[] nullable

Response

Successful

namestring required
activatedboolean
mutedboolean
doubleCheckboolean
shouldFailboolean
locationsstring[] nullable
tagsstring[]
useGlobalAlertSettingsboolean
groupIdnumber nullable
groupOrdernumber nullable
runtimeId'2026.04' | '2025.04' | '2024.09' | '2024.02' | '2023.09' | '2023.02' | '2022.10' | 'null' nullable
runParallelboolean
descriptionstring nullable
idstring
created_atstring date-time
updated_atstring date-time nullable
privateLocationsstring[] nullable
frequency0 | 1 | 2 | 5 | 10 | 15 | 30 | 60 | 120 | 180 | 360 | 720 | 1440
frequencyOffsetinteger
degradedResponseTimenumber nullable
maxResponseTimenumber nullable
checkType'SSL'

Changes

Changed in 2 of the 4 revisions of this API.448139

  • 87d29dc7b4fe303118See the full diff
    • ▲

      request body became required

      request-body-became-required

    • ▲

      for the path request parameter id, the minLength was increased from 0 to 1

      request-parameter-min-length-increased

    • ▲

      for the header request parameter x-checkly-account, the type/format was changed from string/ to string/uuid

      request-parameter-type-changed

    • ▲

      for the path request parameter id, the type/format was changed from string/ to string/uuid

      request-parameter-type-changed

    • ▲

      the request property request/sslConfig/serverName became not nullable

      request-property-became-not-nullable

    • ▲

      the request property request/assertions/items/comparison became required

      request-property-became-required

    • ▲

      the environmentVariables/items/key request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the name request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the privateLocations/items/ request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the request/sslClientCertificateId request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the request/sslConfig/hostname request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the scriptPath request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the tags/items/ request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the triggerIncident/serviceId request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ▲

      the alertSettings/parallelRunFailureThreshold/percentage request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the alertSettings/reminders/amount request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the alertSettings/reminders/interval request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the alertSettings/runBasedEscalation/failedRunThreshold request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the alertSettings/timeBasedEscalation/minutesFailingThreshold request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the request/sslClientCertificateId request property type/format changed from string/ to string/uuid

      request-property-type-changed

    • ▲

      the request/sslConfig/serverName request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the triggerIncident/serviceId request property type/format changed from string/ to string/uuid

      request-property-type-changed

    • ▲

      the response property alertChannels/email/items/address became optional for the status 200

      response-property-became-optional

    • ▲

      the response property alertChannels/slack/items/url became optional for the status 200

      response-property-became-optional

    • ▲

      the response property alertChannels/sms/items/number became optional for the status 200

      response-property-became-optional

    • ▲

      the response property alertChannels/webhook/items/url became optional for the status 200

      response-property-became-optional

    • ▲

      the response property request/sslClientCertificateId became optional for the status 200

      response-property-became-optional

    • ▲

      the request/sslConfig/serverName response property's maxLength was unset from 2048 for the response status 200

      response-property-max-length-unset

    • ▲

      the created_at response's property type/format changed from string/date to string/date-time for status 200

      response-property-type-changed

    • ▲

      the request/sslConfig/serverName response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ●

      removed the optional property attributes from the response with the 401 status

      response-optional-property-removed

    • ●

      removed the optional property attributes from the response with the 429 status

      response-optional-property-removed

    • ●

      added the new undefined enum value to the runtimeId response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new optional request property checkType

      new-optional-request-property

    • ○

      added subschema #1 subschema #2 subschema #3 to the request/sslConfig/serverName request property anyOf list

      request-property-any-of-added

    • ○

      the request property environmentVariables/items/value became nullable

      request-property-became-nullable

    • ○

      the request property heartbeat became nullable

      request-property-became-nullable

    • ○

      the request property script became nullable

      request-property-became-nullable

    • ○

      the request property sslCheckDomain became nullable

      request-property-became-nullable

    • ○

      the request property heartbeat became optional

      request-property-became-optional

    • ○

      the request property request/sslClientCertificateId became optional

      request-property-became-optional

    • ○

      the request property script became optional

      request-property-became-optional

    • ○

      the knownBadCA request property default value {} was added

      request-property-default-value-added

    • ○

      the minKeySizeBits request property default value {} was added

      request-property-default-value-added

    • ○

      the minTLSVersion request property default value {} was added

      request-property-default-value-added

    • ○

      the ocspMustStapleRespected request property default value {} was added

      request-property-default-value-added

    • ○

      the recommendedKeySizeBits request property default value {} was added

      request-property-default-value-added

    • ○

      the recommendedTLSVersion request property default value {} was added

      request-property-default-value-added

    • ○

      the sctPresent request property default value {} was added

      request-property-default-value-added

    • ○

      the weakCipherSuite request property default value {} was added

      request-property-default-value-added

    • ○

      the weakSignatureAlgorithm request property default value {} was added

      request-property-default-value-added

    • ○

      the activated request property default value true was removed

      request-property-default-value-removed

    • ○

      the activated request property default value true was removed

      request-property-default-value-removed

    • ○

      the alertDaysBeforeExpiry request property default value 20 was removed

      request-property-default-value-removed

    • ○

      the alertSettings request property default value {"escalationType":"RUN_BASED","runBasedEscalation":{"failedRunThreshold":1},"reminders":{"amount":0,"interval":5},"parallelRunFailureThreshold":{"enabled":false,"percentage":10}} was removed

      request-property-default-value-removed

    • ○

      the amount request property default value 0 was removed

      request-property-default-value-removed

    • ○

      the baseBackoffSeconds request property default value 60 was removed

      request-property-default-value-removed

    • ○

      the degradedResponseTime request property default value 3000 was removed

      request-property-default-value-removed

    • ○

      the doubleCheck request property default value true was removed

      request-property-default-value-removed

    • ○

      the enabled request property default value false was removed

      request-property-default-value-removed

    • ○

      the enabled request property default value true was removed

      request-property-default-value-removed

    • ○

      the escalationType request property default value RUN_BASED was removed

      request-property-default-value-removed

    • ○

      the frequency request property default value 10 was removed

      request-property-default-value-removed

    • ○

      the handshakeTimeoutMs request property default value 10000 was removed

      request-property-default-value-removed

    • ○

      the interval request property default value 5 was removed

      request-property-default-value-removed

    • ○

      the ipFamily request property default value IPv4 was removed

      request-property-default-value-removed

    • ○

      the locked request property default value false was removed

      request-property-default-value-removed

    • ○

      the maxResponseTime request property default value 10000 was removed

      request-property-default-value-removed

    • ○

      the muted request property default value false was removed

      request-property-default-value-removed

    • ○

      the percentage request property default value 10 was removed

      request-property-default-value-removed

    • ○

      the port request property default value 443 was removed

      request-property-default-value-removed

    • ○

      the regex request property default value was removed

      request-property-default-value-removed

    • ○

      the runParallel request property default value false was removed

      request-property-default-value-removed

    • ○

      the sameRegion request property default value true was removed

      request-property-default-value-removed

    • ○

      the secret request property default value false was removed

      request-property-default-value-removed

    • ○

      the severity request property default value fail was removed

      request-property-default-value-removed

    • ○

      the severity request property default value fail was removed

      request-property-default-value-removed

    • ○

      the severity request property default value fail was removed

      request-property-default-value-removed

    • ○

      the severity request property default value fail was removed

      request-property-default-value-removed

    • ○

      the severity request property default value fail was removed

      request-property-default-value-removed

    • ○

      the severity request property default value ignore was removed

      request-property-default-value-removed

    • ○

      the severity request property default value ignore was removed

      request-property-default-value-removed

    • ○

      the severity request property default value ignore was removed

      request-property-default-value-removed

    • ○

      the severity request property default value ignore was removed

      request-property-default-value-removed

    • ○

      the shouldFail request property default value false was removed

      request-property-default-value-removed

    • ○

      the skipChainValidation request property default value false was removed

      request-property-default-value-removed

    • ○

      the target request property default value was removed

      request-property-default-value-removed

    • ○

      the useGlobalAlertSettings request property default value true was removed

      request-property-default-value-removed

    • ○

      the value request property default value 2048 was removed

      request-property-default-value-removed

    • ○

      the value request property default value 3072 was removed

      request-property-default-value-removed

    • ○

      the value request property default value TLS1.2 was removed

      request-property-default-value-removed

    • ○

      the value request property default value TLS1.3 was removed

      request-property-default-value-removed

    • ○

      added the new undefined enum value to the request property runtimeId

      request-property-enum-value-added

    • ○

      the description request property's maxLength was increased from 500 to 510

      request-property-max-length-increased

    • ○

      removed the pattern ^[^\x00-\x1f\x7f]*$ from the request property request/sslConfig/serverName

      request-property-pattern-removed

    • ○

      added the non-success response with the status 400

      response-non-success-status-added

    • ○

      added subschema #1 subschema #2 subschema #3 to the request/sslConfig/serverName response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      the response property message became required for the status 401

      response-property-became-required

    • ○

      the response property message became required for the status 403

      response-property-became-required

    • ○

      the response property message became required for the status 429

      response-property-became-required

    • ○

      the response property request/assertions/items/comparison became required for the status 200

      response-property-became-required

    • ○

      the headers response's property default value was added for the status 200

      response-property-default-value-added

    • ○

      the knownBadCA response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the locations response's property default value was added for the status 200

      response-property-default-value-added

    • ○

      the minKeySizeBits response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the minTLSVersion response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the ocspMustStapleRespected response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the queryParameters response's property default value was added for the status 200

      response-property-default-value-added

    • ○

      the recommendedKeySizeBits response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the recommendedTLSVersion response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the sctPresent response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the tags response's property default value was added for the status 200

      response-property-default-value-added

    • ○

      the weakCipherSuite response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the weakSignatureAlgorithm response's property default value {} was added for the status 200

      response-property-default-value-added

    • ○

      the activated response's property default value true was removed for the status 200

      response-property-default-value-removed

    • ○

      the alertDaysBeforeExpiry response's property default value 20 was removed for the status 200

      response-property-default-value-removed

    • ○

      the enabled response's property default value true was removed for the status 200

      response-property-default-value-removed

    • ○

      the handshakeTimeoutMs response's property default value 10000 was removed for the status 200

      response-property-default-value-removed

    • ○

      the ipFamily response's property default value IPv4 was removed for the status 200

      response-property-default-value-removed

    • ○

      the port response's property default value 443 was removed for the status 200

      response-property-default-value-removed

    • ○

      the regex response's property default value was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value fail was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value fail was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value fail was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value fail was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value fail was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value ignore was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value ignore was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value ignore was removed for the status 200

      response-property-default-value-removed

    • ○

      the severity response's property default value ignore was removed for the status 200

      response-property-default-value-removed

    • ○

      the skipChainValidation response's property default value false was removed for the status 200

      response-property-default-value-removed

    • ○

      the target response's property default value was removed for the status 200

      response-property-default-value-removed

    • ○

      the value response's property default value was removed for the status 200

      response-property-default-value-removed

    • ○

      the value response's property default value was removed for the status 200

      response-property-default-value-removed

    • ○

      the value response's property default value 2048 was removed for the status 200

      response-property-default-value-removed

    • ○

      the value response's property default value 3072 was removed for the status 200

      response-property-default-value-removed

    • ○

      the value response's property default value TLS1.2 was removed for the status 200

      response-property-default-value-removed

    • ○

      the value response's property default value TLS1.3 was removed for the status 200

      response-property-default-value-removed

    • ○

      removed the 401.00 enum value from the statusCode response property for the response status 401

      response-property-enum-value-removed

    • ○

      removed the 403.00 enum value from the statusCode response property for the response status 403

      response-property-enum-value-removed

    • ○

      removed the 429.00 enum value from the statusCode response property for the response status 429

      response-property-enum-value-removed

    • ○

      removed the DELETE enum value from the alertChannels/webhook/items/method response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the Forbidden enum value from the error response property for the response status 403

      response-property-enum-value-removed

    • ○

      removed the GET enum value from the alertChannels/webhook/items/method response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HEAD enum value from the alertChannels/webhook/items/method response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the PATCH enum value from the alertChannels/webhook/items/method response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the POST enum value from the alertChannels/webhook/items/method response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the PUT enum value from the alertChannels/webhook/items/method response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the Too Many Requests enum value from the error response property for the response status 429

      response-property-enum-value-removed

    • ○

      removed the Unauthorized enum value from the error response property for the response status 401

      response-property-enum-value-removed

    • ○

      the request/sslConfig/serverName response's property pattern ^[^\x00-\x1f\x7f]*$ was removed for the status 200

      response-property-pattern-removed

    This revision also has 566 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 9e903da4f3da14521See the full diff
    • ▲

      removed the enum value CERT_EXPIRES_IN_DAYS of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value CERT_FINGERPRINT_SHA256 of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value CERT_NOT_EXPIRED of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value CHAIN_TRUSTED of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value CIPHER_SUITE of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value HANDSHAKE_TIME_MS of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value HOSTNAME_VERIFIED of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value ISSUER_CN of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value ISSUER_FINGERPRINT_SHA256 of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value KEY_SIZE_BITS of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value OCSP_STAPLED of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value SAN_CONTAINS of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value SIGNATURE_ALGORITHM of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ▲

      removed the enum value TLS_VERSION of the request property request/assertions/items/source

      request-property-enum-value-removed

    • ●

      added the new CERTIFICATE enum value to the request/assertions/items/source response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new CONNECTION enum value to the request/assertions/items/source response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new JSON_RESPONSE enum value to the request/assertions/items/source response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new RESPONSE_TIME enum value to the request/assertions/items/source response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new TEXT_RESPONSE enum value to the request/assertions/items/source response property for the response status 200

      response-property-enum-value-added

    • ○

      the property request property default value was removed

      request-property-default-value-removed

    • ○

      added the new CERTIFICATE enum value to the request property request/assertions/items/source

      request-property-enum-value-added

    • ○

      added the new CONNECTION enum value to the request property request/assertions/items/source

      request-property-enum-value-added

    • ○

      added the new JSON_RESPONSE enum value to the request property request/assertions/items/source

      request-property-enum-value-added

    • ○

      added the new RESPONSE_TIME enum value to the request property request/assertions/items/source

      request-property-enum-value-added

    • ○

      added the new TEXT_RESPONSE enum value to the request property request/assertions/items/source

      request-property-enum-value-added

    • ○

      the property response's property default value was removed for the status 200

      response-property-default-value-removed

    • ○

      removed the CERT_EXPIRES_IN_DAYS enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the CERT_FINGERPRINT_SHA256 enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the CERT_NOT_EXPIRED enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the CHAIN_TRUSTED enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the CIPHER_SUITE enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HANDSHAKE_TIME_MS enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the HOSTNAME_VERIFIED enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the ISSUER_CN enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the ISSUER_FINGERPRINT_SHA256 enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the KEY_SIZE_BITS enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the OCSP_STAPLED enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the SAN_CONTAINS enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the SIGNATURE_ALGORITHM enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the TLS_VERSION enum value from the request/assertions/items/source response property for the response status 200

      response-property-enum-value-removed