---
title: "Changes to Update a multi-step check"
method: PUT
path: "/v1/checks/multistep/{id}"
---

# Changes to Update a multi-step check

`PUT /v1/checks/multistep/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-08-12** `87d29dc7b4fe` — 25 breaking, 3 warning, 50 info

## Changes

- **2026-08-12** `87d29dc7b4fe` — 25 breaking, 3 warning, 50 info
  - request body became required
  - for the `path` request parameter `id`, the minLength was increased from `0` to `1`
  - for the `header` request parameter `x-checkly-account`, the type/format was changed from `string`/`` to `string`/`uuid`
  - for the `path` request parameter `id`, the type/format was changed from `string`/`` to `string`/`uuid`
  - 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 `script` 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 `triggerIncident/serviceId` request property type/format changed from `string`/`` to `string`/`uuid`
  - the response property `environmentVariables/items/value` became nullable for the status `200`
  - the response property `alertChannels/email/items/address` became optional for the status `200`
  - the response property `alertChannels/slack/items/url` became optional for the status `200`
  - the response property `alertChannels/sms/items/number` became optional for the status `200`
  - the response property `alertChannels/webhook/items/url` became optional for the status `200`
  - the `created_at` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200`
  - removed the optional property `attributes` from the response with the `401` 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 `200`
  - the request property `environmentVariables/items/value` became nullable
  - the `activated` request property default value `true` was removed
  - the `activated` request property default value `true` was 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
  - the `amount` request property default value `0` was removed
  - the `baseBackoffSeconds` request property default value `60` was removed
  - the `checkType` request property default value `MULTI_STEP` was removed
  - the `doubleCheck` request property default value `true` was removed
  - the `enabled` request property default value `false` was removed
  - the `escalationType` request property default value `RUN_BASED` was removed
  - the `frequency` request property default value `10` was removed
  - the `interval` request property default value `5` was removed
  - …38 more

---

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