---
title: Run a task
description: Run a data processing task using the InfluxDB UI or the influx CLI.
url: https://docs.influxdata.com/influxdb/cloud/process-data/manage-tasks/run-task/
estimated_tokens: 660
product: InfluxDB Cloud (TSM)
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/cloud/process-data/manage-tasks/run-task/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

InfluxDB data processing tasks generally run in defined intervals or at a specific time,
however, you can manually run a task from the InfluxDB user interface (UI),
the `influx` command line interface (CLI),
or the InfluxDB `/api/v2` API.

## Run a task from the InfluxDB UI

1. In the navigation menu on the left, select **Tasks**.

   Tasks

2. Hover over the task you want to run and click the  icon.

3. Select **Run Task**.

## Run a task with the influx CLI

Use the `influx task run retry` command to run a task.

> [!Note]
> To run a task from the `influx` CLI, the task must have already run at least once.

#### Authentication credentials

The examples below assume your InfluxDB **host**, **organization**, and **token** are
provided by either the [active `influx` CLI configuration](/influxdb/cloud/reference/cli/influx/#provide-required-authentication-credentials) or by environment variables (`INFLUX_HOST`, `INFLUX_ORG`, and `INFLUX_TOKEN`).
If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:

* `--host`: [InfluxDB host](/influxdb/cloud/reference/urls/)
* `-o, --org` or `--org-id`: InfluxDB organization name or ID
* `-t, --token`: InfluxDB API token

```sh
# List all tasks to find the ID of the task to run
influx task list

# Use the task ID to list previous runs of the task
influx task run list --task-id=0000000000000000

# Use the task ID and run ID to retry a run
influx task run retry --task-id=0000000000000000 --run-id=0000000000000000
```

### Retry failed task runs

Use the [`influx task retry-failed` command](/influxdb/cloud/reference/cli/influx/task/retry-failed/)to retry failed task runs.

```sh
# Retry failed tasks for a specific task
influx task retry-failed \
  --id 0000000000000000

# Print information about runs that will be retried
influx task retry-failed \
  --dry-run

# Retry failed task runs that occurred in a specific time range
influx task retry-failed \
  --after 2021-01-01T00:00:00Z \
  --before 2021-01-01T23:59:59Z
```

## Run a task with the InfluxDB API

Use the [`/tasks/TASK_ID/runs` InfluxDB API endpoint](/influxdb/cloud/api/tasks//-taskID-/runs)to manually start a task run.

```
POST http://localhost:8086/api/v2/tasks/TASK_ID/runs
```

### Retry failed task runs

Use the [`/tasks/TASK_ID/runs/RUN_ID/retry` InfluxDB API endpoint](/influxdb/cloud/api/tasks//-taskID-/runs/-runID-/retry)to retry a task run.

```
POST http://localhost:8086/api/v2/tasks/TASK_ID/runs/RUN_ID/retry
```

#### Related

* [influx task run](/influxdb/cloud/reference/cli/influx/task/run/)