conduktor.io ↗

Kafka RenewDelegationToken Request Wire Format v1 — Binary Protocol Layout

What is RenewDelegationToken?

Token holders call this before expiry to extend the token's lifetime, typically on a renewal thread. If renewal fails (e.g., the broker lost in-memory token state in older Kafka), the client must re-authenticate with primary credentials.

Related Errors

DELEGATION_TOKEN_EXPIRED · DELEGATION_TOKEN_NOT_FOUND · DELEGATION_TOKEN_OWNER_MISMATCH · DELEGATION_TOKEN_REQUEST_NOT_ALLOWED

Wire Diagram

Request Header
message_size int32 · 4B
api_key int16 · 2B
api_version int16 · 2B
correlation_id int32 · 4B
client_id string
RenewDelegationTokenRequest v1
Hmac bytes
RenewPeriodMs int64 · 8B

Schema & Example

Schema
{
  "Hmac": bytes,
  "RenewPeriodMs": int64
}
Example
{
  "Hmac": "<binary>",
  "RenewPeriodMs": 0
}