---
title: "Changes to Propose a new Distributed Validator Cluster"
method: POST
path: "/v1/definition"
---

# Changes to Propose a new Distributed Validator Cluster

`POST /v1/definition`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 20 revisions.

- **2026-10-28** `c545dd14c211`: 4 info
- **2026-08-10** `c1aca8ab18b7`: 4 breaking
- **2025-04-23** `02516e7f042a`: 3 breaking
- **2025-03-18** `b91f971e7421`: 4 info
- **2024-12-05** `3896d3513a5d`: 1 breaking, 6 info
- **2024-07-25** `52d1f82e219e`: 1 info

## Changes

- **2026-10-28** `c545dd14c211`: 4 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 `401`
  - 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`
- **2026-08-10** `c1aca8ab18b7`: 4 breaking
  - removed the enum value `0x01017000` of the request property `fork_version`
  - removed the enum value `0x01017000` of the request property `operators/items/fork_version`
  - removed the enum value `holesky` of the request property `fork_version`
  - removed the enum value `holesky` of the request property `operators/items/fork_version`
- **2025-04-23** `02516e7f042a`: 3 breaking
  - added the new required request property `compounding`
  - added the new required request property `consensus_protocol`
  - added the new required request property `target_gas_limit`
- **2025-03-18** `b91f971e7421`: 4 info
  - added the new `0x10000910` enum value to the request property `fork_version`
  - added the new `0x10000910` enum value to the request property `operators/items/fork_version`
  - added the new `hoodi` enum value to the request property `fork_version`
  - added the new `hoodi` enum value to the request property `operators/items/fork_version`
- **2024-12-05** `3896d3513a5d`: 1 breaking, 6 info
  - the `operators` request property's minItems was increased to `3`
  - api operation id `V1DefinitionController_postClusterDefinition` removed and replaced with `DefinitionController_postClusterDefinition_v1`
  - api tag `Cluster Definition` added
  - api tag `V1 Cluster Definition` removed
  - added the required property `anyOf[#/components/schemas/ClusterDefinitionResponse]/compounding` to the response with the `201` status
  - added the required property `anyOf[#/components/schemas/ClusterDefinitionResponse]/consensus_protocol` to the response with the `201` status
  - added the required property `anyOf[#/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/definition/post.md) - [API](https://skmtc.dev/obol/apis/obol-api.md) - [Page](https://skmtc.dev/obol/apis/obol-api/changes/v1/definition/post)