Sign in
Monitors

Update an URL Monitor

Updates an URL monitor.

put/v1/checks/url/{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'URL'
frequency0 | 1 | 2 | 5 | 10 | 15 | 30 | 60 | 120 | 180 | 360 | 720 | 1440
frequencyOffsetinteger
degradedResponseTimenumber nullable
maxResponseTimenumber nullable
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'URL'

Changes

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

  • 87d29dc7b4fe20353See 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 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/url 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 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 created_at response's property type/format changed from string/date to string/date-time 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

    • ○

      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 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 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 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 maxResponseTime request property default value 5000 was removed

      request-property-default-value-removed

    • ○

      the method request property default value GET 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 property request property default value 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 shouldFail request property default value false was removed

      request-property-default-value-removed

    • ○

      the skipSSL 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 url request property default value https://api.checklyhq.com was removed

      request-property-default-value-removed

    • ○

      the useGlobalAlertSettings request property default value true 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

    • ○

      added the non-success response with the status 400

      response-non-success-status-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 assertions response's property default value was added for the status 200

      response-property-default-value-added

    • ○

      the headers 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 queryParameters 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 activated response's property default value true was removed for the status 200

      response-property-default-value-removed

    • ○

      the url response's property default value https://api.checklyhq.com 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

    • ○

      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

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

  • 9e903da4f3da2See the full diff
    • ○

      the degradedResponseTime request property's max was increased from 30000.00 to 45000.00

      request-property-max-increased

    • ○

      the maxResponseTime request property's max was increased from 30000.00 to 45000.00

      request-property-max-increased