conduktor.io ↗

Kafka UnregisterBroker Request Wire Format v0 — Binary Protocol Layout

What is UnregisterBroker?

Permanently removes a broker's registration from the KRaft controller during decommissioning. Unlike a normal shutdown (which just stops heartbeats), this cleans up the broker's presence from the metadata log. Use this when a broker will never rejoin, not during routine maintenance.

Related Errors

BROKER_ID_NOT_REGISTERED

Wire Diagram

Request Header · flexible
message_size int32 · 4B
api_key int16 · 2B
api_version int16 · 2B
correlation_id int32 · 4B
client_id string (compact)
tagged var
UnregisterBrokerRequest v0
BrokerId int32 · 4B
tagged var

Schema & Example

Schema
{
  "BrokerId": int32
}
Example
{
  "BrokerId": 1
}