---
title: "Propose a block to a subnet validator"
method: POST
path: "/v2/block_proposal"
tags: ["Subnet Mining"]
---

# Propose a block to a subnet validator

`POST /v2/block_proposal`

Subnet mining occurs through federation participation. In order for a block to be mined, it must be signed by a quorum of validators. This endpoint allows the quorum leader to propose a block to the validators. The validators check that the block is legal, and return a signature if so.

## Request body

- PostBlockProposalSchemaJson — unresolved $ref

## Response `200`

The block proposal was accepted, and the validator returns their signature as a hex string

- PostBlockProposalOkaySchemaJson — unresolved $ref

## Other responses

- `406` — The block proposal was rejected

## Changes

- **2026-07-17** `7a7617c2d7cc` — 1 info
  - endpoint added
- **2021-02-23** `fc8c7277eb69` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api/changes/v2/block_proposal/post.md)

---

[API](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api.md) · [All operations](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hirosystems/stacks-2-0-rpc-api/revisions/7a7617c2d7cc/schema)