---
title: influx task run
description: The influx task run command and its subcommand, list output information related to runs of a task.
url: https://docs.influxdata.com/influxdb/v2/reference/cli/influx/task/run/
estimated_tokens: 462
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/reference/cli/influx/task/run/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

* influx CLI 2.0.0+
* InfluxDB 2.0.0+

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

The `influx task run` command and its subcommand `list` output information related to runs of a task.

## Usage

```
influx task run [flags]
influx task run [command]
```

## Subcommands

|                       Subcommand                        |    Description     |
|---------------------------------------------------------|--------------------|
| [list](/influxdb/v2/reference/cli/influx/task/run/list) |List runs for a task|
|[retry](/influxdb/v2/reference/cli/influx/task/run/retry)|    Retry a task    |

## Flags

|Flag|        |       Description        |
|----|--------|--------------------------|
|`-h`|`--help`|Help for the `run` command|

#### Related

* [Process data with InfluxDB tasks](/influxdb/v2/process-data/)
* [influx CLI—Provide required authentication credentials](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials)
* [influx CLI—Flag patterns and conventions](/influxdb/v2/reference/cli/influx/#flag-patterns-and-conventions)
| Subcommand | Description |
| --- | --- |
| Subcommand | Description |
| list | List runs for a task |
| retry | Retry a task |

| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
| -h | --help | Help for the  run  command |