Skip to main content

tctl v1.17 activity command reference

Temporal CLI is now available

The public preview of Temporal CLI is now available. We encourage you to begin using it and to provide feedback.

After the release of Temporal CLI v1.0, tctl will deprecate.

The tctl activity commands enable Activity Execution operations.

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>