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

tctl v1.17 activity command reference

View Markdown

tctl is deprecated

The tctl command line utility has been deprecated and is no longer actively supported. We recommend transitioning to Temporal CLI for continued use and access to new features.

Thank you for being a valued part of the Temporal community.

The tctl activity commands enable Activity Execution operations.

• tctl activity complete
• tctl activity fail

complete

The tctl activity complete command completes an Activity Execution.

tctl activity complete <modifiers>

The following modifiers control the behavior of the command.

--workflow_id

Specify the Workflow Id of an Activity Execution to complete.

Alias: -w

Example

tctl activity complete --workflow_id <id>

--run_id

Specify the Run Id of an Activity Execution to complete.

Alias: -r

Example

tctl activity complete --run_id <id>

--activity_id

Specify the Activity Id of an Activity Execution to complete.

Example

tctl activity complete --activity_id <id>

--result

Specify the result of an Activity Execution when using tctl to complete the Activity Execution.

Example

tctl activity complete --result <value>

--identity

Specify the identity of the operator when using tctl to complete an Activity Execution.

Example

tctl activity complete --identity <value>

fail

The tctl activity fail command fails an Activity Execution.

tctl activity fail [<modifiers>]

The following modifiers control the behavior of the command.

--workflow_id

Specify the Workflow Id of an Activity Execution to fail.

Alias: -w

Example

tctl activity fail --workflow_id <id>

--run_id

Specify the Run Id of an Activity Execution to fail.

Alias: -r

Example

tctl activity fail --run_id <id>

--activity_id

Specify the Activity Id of an Activity Execution to fail.

Example

tctl activity fail --activity_id <id>

--reason

Specify the reason for failing an Activity Execution.

Example

tctl activity fail --reason <value>

--detail

Specify details of the reason for failing an Activity Execution.

Example

tctl activity fail --detail <value>

--identity

Specify the identity of the operator when using tctl to fail an Activity Execution.

Example

tctl activity complete --identity <value>