Temporal CLI workflow command reference
Workflow commands allow operations to be performed on Workflow Executions
What is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
cancel
The temporal workflow cancel command cancels a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
Canceling a running Workflow Execution records a WorkflowExecutionCancelRequested event in the Event HistoryWhat is an Event History?
An append log of Events that represents the full state a Workflow Execution.
Learn more.
A new CommandWhat is a Command?
A Command is a requested action issued by a Worker to the Temporal Cluster after a Workflow Task Execution completes.
Learn more Task will be scheduled, and the Workflow Execution performs cleanup work.
Use the options listed below to change the behavior of this command.
Make sure to write the command as follows:
temporal workflow cancel [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --querytemporal query
Visibility Query of Search Attributes describing the Workflow Executions to reset.
Learn more - --reasontemporal reason
Reason for the operation
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more - --yestemporal yes
Confirm all prompts.
Learn more
count
The temporal workflow count command returns a count of Workflow ExecutionsWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
This command requires Elasticsearch to be enabled.
Use the options listed below to change the command's behavior.
Make sure to write the command as follows:
temporal workflow count [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --querytemporal query
Visibility Query of Search Attributes describing the Workflow Executions to reset.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more
delete
The temporal workflow delete command deletes the specified Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
Use the options listed below to change the command's behavior.
Make sure to write the command as follows:
temporal workflow delete [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
describe
The temporal workflow describe command shows information about a given Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
This information can be used to locate Workflow Executions that weren't able to run successfully.
Use the command options listed below to change the information returned by this command.
Make sure to write the command in this format:
temporal workflow describe [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --rawtemporal raw
Print raw data as json (prefer this over -o json for scripting).
Learn more - --reset-pointstemporal reset-points
Only show Workflow Events that are eligible for reset.
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
execute
The temporal workflow execute command starts a new Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more and prints its progress.
The command doesn't finish until the WorkflowWhat is a Workflow?
In day-to-day conversations, the term "Workflow" frequently denotes either a Workflow Type, a Workflow Definition, or a Workflow Execution.
Learn more completes.
Single quotes('') are used to wrap input as JSON.
Use the command options listed below to change how the Workflow Execution behaves during its run.
Make sure to write the command in this format:
temporal workflow execute [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --crontemporal cron
Optional Cron Schedule for the Workflow.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --execution-timeouttemporal execution-timeout
Timeout (in seconds) for a WorkflowExecution, including retries and continue-as-new tasks.
Learn more - --fieldstemporal fields
Customize fields to print.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --id-reuse-policytemporal id-reuse-policy
Allows the same Workflow Id to be used in a new Workflow Execution.
Learn more - --inputtemporal input
Optional JSON input to provide to the Workflow.
Learn more - --input-filetemporal input-file
Passes optional input for the Workflow from a JSON file.
Learn more - --limittemporal limit
Number of items to print.
Learn more - --max-field-lengthtemporal max-field-length
Maximum length for each attribute field.
Learn more - --memotemporal memo
Set a memo on a schedule (in key=value format).
Learn more - --memo-filetemporal memo-file
Set a memo from a file.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --no-pagertemporal no-pager
Disables the interactive pager.
Learn more - --outputtemporal output
format output as either table, json, card.
Learn more - --pagertemporal pager
Sets the pager for Temporal CLI to use.
Learn more - --run-timeouttemporal run-timeout
Timeout (in seconds) of a single Workflow run.
Learn more - --search-attributetemporal search-attribute
Set Search Attribute on a schedule.
Learn more - --task-queuetemporal task-queue
Task Queue
Learn more - --task-timeouttemporal task-timeout
Start-to-close timeout for a Workflow Task (in seconds).
Learn more - --time-formattemporal time-format
Format time as either relative, iso, raw.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --typetemporal type
Search attribute type.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
list
The temporal workflow list command provides a list of Workflow ExecutionsWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more that meet the criteria of a given QueryWhat is a Query?
A Query is a synchronous operation that is used to report the state of a Workflow Execution.
Learn more.
By default, this command returns a list of up to 10 closed Workflow Executions.
Use the command options listed below to change the information returned by this command.
Make sure to write the command as follows:
temporal workflow list [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --archivedtemporal archived
List archived Workflow Executions.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --fieldstemporal fields
Customize fields to print.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --limittemporal limit
Number of items to print.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --no-pagertemporal no-pager
Disables the interactive pager.
Learn more - --outputtemporal output
format output as either table, json, card.
Learn more - --pagertemporal pager
Sets the pager for Temporal CLI to use.
Learn more - --querytemporal query
Visibility Query of Search Attributes describing the Workflow Executions to reset.
Learn more - --time-formattemporal time-format
Format time as either relative, iso, raw.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more
query
The temporal workflow query command sends a QueryWhat is a Query?
A Query is a synchronous operation that is used to report the state of a Workflow Execution.
Learn more to a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
Queries can retrieve all or part of the Workflow state within given parameters.
Queries can also be used on completed WorkflowsWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
Use the command options listed below to change the information returned by this command.
Make sure to write the command as follows:
temporal workflow query [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --inputtemporal input
Optional JSON input to provide to the Workflow.
Learn more - --input-filetemporal input-file
Passes optional input for the Workflow from a JSON file.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --reject-conditiontemporal reject-condition
Optional flag for rejecting Queries based on Workflow state.
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --typetemporal type
Search attribute type.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
reset
The temporal workflow reset command resets a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
A reset allows the Workflow to be resumed from a certain point without losing your parameters or Event HistoryWhat is an Event History?
An append log of Events that represents the full state a Workflow Execution.
Learn more.
Use the options listed below to change reset behavior.
Make sure to write the command as follows:
temporal workflow reset [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --event-idtemporal event-id
The Event Id for any Event after WorkflowTaskStarted you want to reset to (exclusive).
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --reapply-typetemporal reapply-type
Event types to reapply after the reset point.
Learn more - --reasontemporal reason
Reason for the operation
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --typetemporal type
Search attribute type.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
reset-batch
The temporal workflow reset-batch command resets a batch of Workflow ExecutionsWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more by resetType.
Resetting a WorkflowWhat is a Workflow?
In day-to-day conversations, the term "Workflow" frequently denotes either a Workflow Type, a Workflow Definition, or a Workflow Execution.
Learn more allows the process to resume from a certain point without losing your parameters or Event HistoryWhat is an Event History?
An append log of Events that represents the full state a Workflow Execution.
Learn more.
Use the options listed below to change reset behavior.
Make sure to write the command as follows:
temporal workflow reset-batch [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --dry-runtemporal dry-run
Simulate reset without resetting any Workflow Executions.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --exclude-filetemporal exclude-file
Input file that specifies Workflow Executions to exclude from resetting.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --input-filetemporal input-file
Passes optional input for the Workflow from a JSON file.
Learn more - --input-parallelismtemporal input-parallelism
Number of goroutines to run in parallel.
Learn more - --input-separatortemporal input-separator
Separator for the input file.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --non-deterministictemporal non-deterministic
Reset Workflow Execution only if its last Event is WorkflowTaskFailed with a nondeterministic error.
Learn more - --querytemporal query
Visibility Query of Search Attributes describing the Workflow Executions to reset.
Learn more - --reasontemporal reason
Reason for the operation
Learn more - --skip-base-is-not-currenttemporal skip-base-is-not-current
Skip a Workflow Execution if the base Run is not the current Run.
Learn more - --skip-current-opentemporal skip-current-open
Skip a Workflow Execution if the current Run is open for the same Workflow Id as the base Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --typetemporal type
Search attribute type.
Learn more
show
The temporal workflow show command provides the Event HistoryWhat is an Event History?
An append log of Events that represents the full state a Workflow Execution.
Learn more for a specified Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
Use the options listed below to change the command's behavior.
Make sure to write the command as follows:
temporal workflow show [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --fieldstemporal fields
Customize fields to print.
Learn more - --followtemporal follow
Follow the progress of a Workflow Execution.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --limittemporal limit
Number of items to print.
Learn more - --max-field-lengthtemporal max-field-length
Maximum length for each attribute field.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --no-pagertemporal no-pager
Disables the interactive pager.
Learn more - --outputtemporal output
format output as either table, json, card.
Learn more - --output-filenametemporal output-filename
Serializes Event History to a file.
Learn more - --pagertemporal pager
Sets the pager for Temporal CLI to use.
Learn more - --reset-pointstemporal reset-points
Only show Workflow Events that are eligible for reset.
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --time-formattemporal time-format
Format time as either relative, iso, raw.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
signal
The temporal workflow signal command is used to SignalWhat is a Signal?
A Signal is an asynchronous request to a Workflow Execution.
Learn more a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more by ID or List FilterWhat is a List Filter?
A List Filter is the SQL-like string that is provided as the parameter to an Advanced Visibility List API.
Learn more.
Use the options listed below to change the command's behavior.
Make sure to write the command as follows:
temporal workflow signal [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --inputtemporal input
Optional JSON input to provide to the Workflow.
Learn more - --input-filetemporal input-file
Passes optional input for the Workflow from a JSON file.
Learn more - --nametemporal name
Frontend address of the remote Cluster.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --querytemporal query
Visibility Query of Search Attributes describing the Workflow Executions to reset.
Learn more - --reasontemporal reason
Reason for the operation
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more - --yestemporal yes
Confirm all prompts.
Learn more
stack
The temporal workflow stack command queries a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more with --stack-trace as the QueryWhat is a Query?
A Query is a synchronous operation that is used to report the state of a Workflow Execution.
Learn more type.
Returning the stack trace of all the threads owned by a Workflow Execution can be great for troubleshooting in production.
Use the options listed below to change the command's behavior.
Make sure to write the command as follows:
temporal workflow stack [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --inputtemporal input
Optional JSON input to provide to the Workflow.
Learn more - --input-filetemporal input-file
Passes optional input for the Workflow from a JSON file.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --reject-conditiontemporal reject-condition
Optional flag for rejecting Queries based on Workflow state.
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
start
The temporal workflow start command starts a new Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more.
When invoked successfully, the Workflow and Run ID are returned immediately after starting the WorkflowWhat is a Workflow?
In day-to-day conversations, the term "Workflow" frequently denotes either a Workflow Type, a Workflow Definition, or a Workflow Execution.
Learn more.
Use the command options listed below to change how the Workflow Execution behaves upon starting.
Make sure to write the command in this format:
temporal workflow start [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --crontemporal cron
Optional Cron Schedule for the Workflow.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --execution-timeouttemporal execution-timeout
Timeout (in seconds) for a WorkflowExecution, including retries and continue-as-new tasks.
Learn more - --fieldstemporal fields
Customize fields to print.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --id-reuse-policytemporal id-reuse-policy
Allows the same Workflow Id to be used in a new Workflow Execution.
Learn more - --inputtemporal input
Optional JSON input to provide to the Workflow.
Learn more - --input-filetemporal input-file
Passes optional input for the Workflow from a JSON file.
Learn more - --limittemporal limit
Number of items to print.
Learn more - --max-field-lengthtemporal max-field-length
Maximum length for each attribute field.
Learn more - --memotemporal memo
Set a memo on a schedule (in key=value format).
Learn more - --memo-filetemporal memo-file
Set a memo from a file.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --no-pagertemporal no-pager
Disables the interactive pager.
Learn more - --outputtemporal output
format output as either table, json, card.
Learn more - --pagertemporal pager
Sets the pager for Temporal CLI to use.
Learn more - --run-timeouttemporal run-timeout
Timeout (in seconds) of a single Workflow run.
Learn more - --search-attributetemporal search-attribute
Set Search Attribute on a schedule.
Learn more - --task-queuetemporal task-queue
Task Queue
Learn more - --task-timeouttemporal task-timeout
Start-to-close timeout for a Workflow Task (in seconds).
Learn more - --time-formattemporal time-format
Format time as either relative, iso, raw.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --typetemporal type
Search attribute type.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more
terminate
The temporal workflow terminate command terminates a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more
Terminating a running Workflow Execution records a WorkflowExecutionTerminated event as the closing Event in the Event HistoryWhat is an Event History?
An append log of Events that represents the full state a Workflow Execution.
Learn more.
Any further CommandWhat is a Command?
A Command is a requested action issued by a Worker to the Temporal Cluster after a Workflow Task Execution completes.
Learn more Tasks cannot be scheduled after running this command.
Use the options listed below to change termination behavior.
Make sure to write the command as follows:
temporal workflow terminate [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --querytemporal query
Visibility Query of Search Attributes describing the Workflow Executions to reset.
Learn more - --reasontemporal reason
Reason for the operation
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more - --yestemporal yes
Confirm all prompts.
Learn more
trace
The temporal workflow trace command tracks the progress of a Workflow ExecutionWhat is a Workflow Execution?
A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.
Learn more and any Child WorkflowsWhat is a Child Workflow Execution?
A Child Workflow Execution is a Workflow Execution that is spawned from within another Workflow.
Learn more it generates.
Use the options listed below to change the command's behavior.
Make sure to write the command as follows:
temporal workflow trace [command options]
- --addresstemporal address
The host and port for the Temporal Frontend Service.
Learn more - --codec-authtemporal codec-auth
Sets the authorization header on requests to the Codec Server.
Learn more - --codec-endpointtemporal codec-endpoint
Endpoint for a remote Codec Server.
Learn more - --colortemporal color
When to use color
Learn more - --concurrencytemporal concurrency
Request concurrency.
Learn more - --context-timeouttemporal context-timeout
An optional timeout for the context of an RPC call.
Learn more - --depthtemporal depth
Number of Child Workflows to expand.
Learn more - --envtemporal env
Name of the environment to read environmental variables from.
Learn more - --foldtemporal fold
Statuses for which Child Workflows will be folded in (this will reduce the number of information fetched and displayed).
Learn more - --grpc-metatemporal grpc-meta
Contains gRPC metadata to send with requests.
Learn more - --namespacetemporal namespace
Identifies a Namespace in the Temporal Workflow.
Learn more - --no-foldtemporal no-fold
Disable folding. All Child Workflows within the set depth will be fetched and displayed.
Learn more - --run-idtemporal run-id
Identifies the current Workflow Run.
Learn more - --tls-ca-pathtemporal tls-ca-path
Path to server CA certificate.
Learn more - --tls-cert-pathtemporal tls-cert-path
Path to x509 certificate.
Learn more - --tls-disable-host-verificationtemporal tls-disable-host-verification
Disables TLS host name verification if already enabled.
Learn more - --tls-key-pathtemporal tls-key-path
Path to private certificate key.
Learn more - --tls-server-nametemporal tls-server-name
Provides an override for the target TLS server name.
Learn more - --workflow-idtemporal workflow-id
Workflow Id
Learn more