# tctl v1.17 activity command reference

> Experience the new Temporal CLI public preview for streamlined Workflow and Activity management. Utilize tctl commands like `complete` and `fail` with various modifiers for precise control.

> **ℹ️ Info:**
> tctl is deprecated
>
> The tctl command line utility has been deprecated and is no longer actively supported.
> We recommend transitioning to [Temporal CLI](/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](/activity-execution) operations.

- [tctl activity complete](#complete)
- [tctl activity fail](#fail)

## complete

The `tctl activity complete` command completes an [Activity Execution](/activity-execution).

`tctl activity complete <modifiers>`

The following modifiers control the behavior of the command.

### --workflow_id

Specify the [Workflow Id](/workflow-execution/workflowid-runid#workflow-id) of an [Activity Execution](/activity-execution) to complete.

Alias: `-w`

**Example**

```bash
tctl activity complete --workflow_id <id>
```

### --run_id

Specify the [Run Id](/workflow-execution/workflowid-runid#run-id) of an [Activity Execution](/activity-execution) to complete.

Alias: `-r`

**Example**

```bash
tctl activity complete --run_id <id>
```

### --activity_id

Specify the [Activity Id](/activity-execution#activity-id) of an [Activity Execution](/activity-execution) to complete.

**Example**

```bash
tctl activity complete --activity_id <id>
```

### --result

Specify the result of an [Activity Execution](/activity-execution) when using tctl to complete the Activity Execution.

**Example**

```bash
tctl activity complete --result <value>
```

### --identity

Specify the identity of the operator when using tctl to complete an [Activity Execution](/activity-execution).

**Example**

```bash
tctl activity complete --identity <value>
```

## fail

The `tctl activity fail` command fails an [Activity Execution](/activity-execution).

`tctl activity fail [<modifiers>]`

The following modifiers control the behavior of the command.

### --workflow_id

Specify the [Workflow Id](/workflow-execution/workflowid-runid#workflow-id) of an [Activity Execution](/activity-execution) to fail.

Alias: `-w`

**Example**

```bash
tctl activity fail --workflow_id <id>
```

### --run_id

Specify the [Run Id](/workflow-execution/workflowid-runid#run-id) of an [Activity Execution](/activity-execution) to fail.

Alias: `-r`

**Example**

```bash
tctl activity fail --run_id <id>
```

### --activity_id

Specify the [Activity Id](/activity-execution#activity-id) of an [Activity Execution](/activity-execution) to fail.

**Example**

```bash
tctl activity fail --activity_id <id>
```

### --reason

Specify the reason for failing an [Activity Execution](/activity-execution).

**Example**

```bash
tctl activity fail --reason <value>
```

### --detail

Specify details of the reason for failing an [Activity Execution](/activity-execution).

**Example**

```bash
tctl activity fail --detail <value>
```

### --identity

Specify the identity of the operator when using tctl to fail an [Activity Execution](/activity-execution).

**Example**

```bash
tctl activity complete --identity <value>
```
