---
title: "Changes to Push Distributed Validator Cluster Lock Data"
method: POST
path: "/v1/lock"
---

# Changes to Push Distributed Validator Cluster Lock Data

`POST /v1/lock`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 20 revisions.

- **2026-10-28** `c545dd14c211`: 6 info
- **2026-10-22** `ffbd09536a1a`: 4 info
- **2026-08-10** `c1aca8ab18b7`: 3 info
- **2024-12-05** `3896d3513a5d`: 9 breaking, 4 info
- **2024-07-25** `52d1f82e219e`: 1 info

## Changes

- **2026-10-28** `c545dd14c211`: 6 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `409`
  - added the media type `application/json` for the response with the status `500`
  - added the media type `application/json` for the response with the status `503`
  - added the media type `application/json` for the response with the status `504`
- **2026-10-22** `ffbd09536a1a`: 4 info
  - added the non-success response with the status `409`
  - added the required property `anyOf[#/components/schemas/ClusterLockResponse]/definition_stored` to the response with the `201` status
  - added the required property `anyOf[#/components/schemas/ClusterLockResponse]/is_current` to the response with the `201` status
  - added the required property `anyOf[#/components/schemas/ClusterLockResponse]/superseded_by` to the response with the `201` status
- **2026-08-10** `c1aca8ab18b7`: 3 info
  - added the non-success response with the status `503`
  - added the non-success response with the status `504`
  - removed the non-success response with the status `409`
- **2024-12-05** `3896d3513a5d`: 9 breaking, 4 info
  - added the new required request property `cluster_definition/allOf[#/components/schemas/ClusterDefinitionResponse]/compounding`
  - added the new required request property `cluster_definition/allOf[#/components/schemas/ClusterDefinitionResponse]/consensus_protocol`
  - added the new required request property `cluster_definition/allOf[#/components/schemas/ClusterDefinitionResponse]/target_gas_limit`
  - added the pattern `^(0x|0h)?[0-9A-F]+$` to the request property `distributed_validators/items/builder_registration/allOf[#/components/schemas/BuilderRegistrationDto]/message/allOf[#/components/schemas/BuilderRegistrationMessageDto]/pubkey`
  - added the pattern `^(0x|0h)?[0-9A-F]+$` to the request property `distributed_validators/items/deposit_data/allOf[#/components/schemas/DepositDataDto]/pubkey`
  - added the pattern `^(0x|0h)?[0-9A-F]+$` to the request property `distributed_validators/items/distributed_public_key`
  - added the pattern `^(0x|0h)?[0-9A-F]+$` to the request property `distributed_validators/items/partial_deposit_data/allOf[#/components/schemas/DepositDataDto]/pubkey`
  - added the pattern `^(0x|0h)?[0-9A-F]+$` to the request property `distributed_validators/items/public_shares/items/`
  - added the pattern `^(0x|0h)?[0-9A-F]+$` to the request property `node_signatures/items/`
  - api operation id `LockController_postClusterLock` removed and replaced with `LockController_postClusterLock[1]_v1`
  - added the required property `anyOf[#/components/schemas/ClusterLockResponse]/cluster_definition/allOf[#/components/schemas/ClusterDefinitionResponse]/compounding` to the response with the `201` status
  - added the required property `anyOf[#/components/schemas/ClusterLockResponse]/cluster_definition/allOf[#/components/schemas/ClusterDefinitionResponse]/consensus_protocol` to the response with the `201` status
  - added the required property `anyOf[#/components/schemas/ClusterLockResponse]/cluster_definition/allOf[#/components/schemas/ClusterDefinitionResponse]/target_gas_limit` to the response with the `201` status
- **2024-07-25** `52d1f82e219e`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/obol/apis/obol-api/docs/v1/lock/post.md) - [API](https://skmtc.dev/obol/apis/obol-api.md) - [Page](https://skmtc.dev/obol/apis/obol-api/changes/v1/lock/post)