Docs / Transformers / Map Keys

Map Keys

Rename, extract, or reshape payload keys.

Ports

Inlet
Input (any)
Outlet
Output (any)

Configuration

Parameter Type Default Description
mappings key-value pairs A list of old key → new key pairs. Supports dot-notation for nested keys (e.g., resp.dataitems).
passthrough boolean true When true, unmapped keys are included in the output. When false, only explicitly mapped keys appear.

Output Payload

The output payload is shaped by the configured mappings. Mapped keys are renamed; unmapped keys are passed through or dropped depending on the passthrough setting.

Example