For the complete documentation index, see /llms.txt. This page is also available as raw Markdown at /cli/command-reference/batch.md. Append .md to any page URL to fetch its Markdown.

Temporal CLI batch command reference

View Markdown

This page provides a reference for the temporal CLI batch command. The flags applicable to each subcommand are presented in a table within the heading for the subcommand. Refer to Global Flags for flags that you can use with every subcommand.

describe

Show the progress of an ongoing batch job. Pass a valid job ID to display its information:

temporal batch describe \
    --job-id YourJobId

Use the following options to change the behavior of this command. You can also use any of the global flags that apply to all subcommands.

Flag	Required	Description
--job-id	Yes	string Batch job ID.

list

Return a list of batch jobs on the Service or within a single Namespace. For example, list the batch jobs for "YourNamespace":

temporal batch list \
    --namespace YourNamespace

Use the following options to change the behavior of this command. You can also use any of the global flags that apply to all subcommands.

Flag	Required	Description
--limit	No	int Maximum number of batch jobs to display.

terminate

Terminate a batch job with the provided job ID. You must provide a reason for the termination. The Service stores this explanation as metadata for the termination event for later reference:

temporal batch terminate \
    --job-id YourJobId \
    --reason YourTerminationReason

Use the following options to change the behavior of this command. You can also use any of the global flags that apply to all subcommands.

Flag	Required	Description
--job-id	Yes	string Job ID to terminate.
--reason	Yes	string Reason for terminating the batch job.

Global Flags

The following options can be used with any command.

Flag	Required	Description	Default
--address	No	string Temporal Service gRPC endpoint.	localhost:7233
--api-key	No	string API key for request.
--client-authority	No	string Temporal gRPC client :authority pseudoheader.
--client-connect-timeout	No	duration Client connection timeout.
--codec-auth	No	string Authorization header for Codec Server requests.
--codec-endpoint	No	string Remote Codec Server endpoint.
--codec-header	No	string[] HTTP headers for codec server (KEY=VALUE, repeatable).
--color	No	string-enum Output coloring. Accepted values: always, never, auto.	auto
--command-timeout	No	duration Command execution timeout.
--config-file	No	string TOML config file path.
--disable-config-env	No	bool Disable loading config from environment variables.
--disable-config-file	No	bool Disable loading config from file.
--env	No	string Active environment name (ENV).	default
--env-file	No	string Path to environment settings file.
--grpc-meta	No	string[] HTTP headers for requests (KEY=VALUE, repeatable).
--identity	No	string Identity of the client submitting requests.
--log-format	No	string-enum Log format. Accepted values: text, json.	text
--log-level	No	string-enum Log level. Default is "never" for most commands and "warn" for "server start-dev". Accepted values: debug, info, warn, error, never.	never
--namespace, -n	No	string Temporal Service Namespace.	default
--no-json-shorthand-payloads	No	bool Raw payload output, even if the JSON option was used.
--output, -o	No	string-enum Non-logging data output format. Accepted values: text, json, jsonl, none.	text
--profile	No	string Profile to use for config file.
--time-format	No	string-enum Time format. Accepted values: relative, iso, raw.	relative
--tls	No	bool Enable base TLS encryption. Auto-enabled when api-key or TLS options are set.
--tls-ca-data	No	string Inline server CA certificate data.
--tls-ca-path	No	string Path to server CA certificate.
--tls-cert-data	No	string Inline x509 certificate data.
--tls-cert-path	No	string Path to x509 certificate.
--tls-disable-host-verification	No	bool Disable TLS host-name verification.
--tls-key-data	No	string Inline x509 private key data.
--tls-key-path	No	string Path to x509 private key.
--tls-server-name	No	string Override target TLS server name.