---
title: "Upload a Stacks block"
method: POST
path: "/v2/blocks/upload/{consensus_hash}"
tags: ["Mining"]
---

# Upload a Stacks block

`POST /v2/blocks/upload/{consensus_hash}`

Upload a Stacks block to the node for processing.
The block must be in binary format and associated with the given consensus hash.

## Path parameters

- `consensus_hash` string, required

## Response `200`

Block upload result

- BlockUploadResponse — unresolved $ref

## Other responses

- `400` — Bad request
- `404` — Not found
- `500` — Internal Server Error

## Changes

- **2026-01-28** `30468ca2533f` — 1 breaking
  - the request's body minLength was increased from `0` to `1`
- **2026-01-14** `f7f733b4a1fc` — 1 info
  - the request's body minLength was decreased from `1` to `0`
- **2026-01-14** `eb2153a4a3ad` — 1 breaking
  - the request's body minLength was increased from `0` to `1`
- **2026-01-02** `96224b968a3e` — 1 info
  - the request's body minLength was decreased from `1` to `0`
- **2025-12-18** `97e7080a8130` — 1 breaking
  - the request's body minLength was increased from `0` to `1`

[Full history](https://skmtc.dev/stacks-network/apis/stacks-3-0-rpc-api/changes/v2/blocks/upload/:consensus_hash/post.md)

---

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