Temporal CLI workflow start accepts headers
Introduced 2026-02-05 · score 0.96
HOW TO USE IT
When starting a Workflow Execution with Temporal CLI, use `temporal workflow start` and pass each header as a repeatable `--headers KEY=VALUE` option. Header keys must be identifiers and values must be JSON values.
temporal workflow start \
--workflow-id <WorkflowId> \
--type <WorkflowType> \
--task-queue <TaskQueue> \
--headers 'my-header="value"' \
--headers 'another-header=123'WHY THIS HELPS
Start a workflow with headers set from the Temporal CLI.
REQUIREMENTS AND LIMITATIONS
- Version: v1.6.0
- --headers: Repeatable `KEY=VALUE` workflow header; keys must be identifiers and values must be JSON values. Sets workflow headers, not gRPC headers.
- --workflow-id: Workflow ID; if omitted, the Service generates a unique ID.
- --type (required): Workflow Type name.
- --task-queue (required): Workflow Task queue.
FIRST-PARTY EVIDENCE
- https://github.com/temporalio/cli/releases/tag/v1.6.0
- https://github.com/temporalio/cli/pull/883
- https://docs.temporal.io/cli/command-reference/workflow
Check the installed version and the source before using it. Entry JSON