---
title: Manage Kapacitor Flux task runs
description: Use the kapacitor CLI or the Kapacitor HTTP API to manage Kapacitor Flux task runs.
url: https://docs.influxdata.com/kapacitor/v1/working/flux/manage/task-runs/
estimated_tokens: 1302
product: Kapacitor
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/kapacitor/v1/working/flux/manage/task-runs/
date: '2023-10-03T10:49:57-06:00'
lastmod: '2023-10-03T10:49:57-06:00'
---

Use the **`kapacitor` CLI** or the **Kapacitor HTTP API** to manage Kapacitor Flux task runs.
Each Flux task execution is considered a “run.”

#### CLI ####

Use the `kapacitor flux task run list` command and its sub commands to manage
Kapacitor Flux task runs.

* [List Kapacitor Flux tasks runs](#list-kapacitor-flux-tasks-runs)
* [Retry a Kapacitor Flux task run](#retry-a-kapacitor-flux-task-run)

## List Kapacitor Flux tasks runs

Use the `kapacitor flux task run list` command to output Kapacitor Flux task logs.
Provide the following flags:

\* Required

* \* `--task-id`: Task ID
* `--run-id`: Filter by run ID
* `--before`: Return task runs that occurred before this time (RFC3339 timestamp)
* `--after`: Return task runs that occurred after this time (RFC3339 timestamp)
* `--limit`: Limit the number of returned task runs (default is 100)

### CLI Examples

* [List runs for a Flux task](#list-runs-for-a-flux-task)
* [List Flux task runs that occurred in a time range](#list-flux-task-runs-that-occurred-in-a-time-range)
* [List a limited number of Flux task runs](#list-a-limited-number-of-flux-task-runs)

##### List runs for a Flux task

```sh
kapacitor flux task run list --task-id 000x00xX0xXXx00
```

##### List Flux task runs that occurred in a time range

```sh
kapacitor flux task run list \
  --task-id 000x00xX0xXXx00 \
  --after 2021-01-01T00:00:00Z \
  --before 2021-01-31T00:00:00Z
```

##### List a limited number of Flux task runs

```sh
kapacitor flux task run list \
  --task-id 000x00xX0xXXx00 \
  --limit 10
```

## Retry a Kapacitor Flux task run

Use the `kapacitor flux task run retry` command to retry a Kapacitor Flux task run.
Provide the following flags:

\* Required

* \* `--task-id`: Task ID
* \* `--run-id`: Run ID

```sh
kapacitor flux task run retry \
  --task-id 000x00xX0xXXx00 \
  --run-id XXX0xx0xX00Xx0X
```

* [List Kapacitor Flux task runs](#list-kapacitor-flux-task-runs)
* [Retry a Kapacitor Flux task run](#retry-a-kapacitor-flux-task-run-api)

## List Kapacitor Flux task runs

Use the following request method and endpoint to list Kapacitor Flux task runs.

```
GET /kapacitor/v1/api/v2/tasks/{taskID}/runs
```

Provide the following with your request (\* Required):

#### Headers

* \* **Content-type:** application/json

#### Path parameters

* \* **taskID**: Task ID

#### Query parameters

* **after**: List task runs after a specific run ID
* **afterTime**: Return task runs that occurred after this time (RFC3339 timestamp)
* **beforeTime**: Return task runs that occurred before this time (RFC3339 timestamp)
* **limit**: Limit the number of task runs returned (default is 100)

### API examples

*The following examples use the task ID `000x00xX0xXXx00`.*

* [List all runs for a Flux task](#list-all-runs-for-a-flux-task)
* [List a limited number of runs for a Flux task](#list-a-limited-number-of-runs-for-a-flux-task)
* [List Flux task runs after a specific run ID](#list-flux-task-runs-after-a-specific-run-id)
* [List Flux task runs that occurred in a time range](#list-flux-task-runs-that-occurred-in-a-time-range-api)

##### List all runs for a Flux task

```sh
curl --GET 'http://localhost:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json'
```

##### List a limited number of runs for a Flux task

```sh
curl --GET 'http://localhost:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json' \
  --data-urlencode "limit=10"
```

##### List Flux task runs after a specific run ID

```sh
curl --GET 'http://localhost:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json' \
  --data-urlencode "after=XXX0xx0xX00Xx0X"
```

##### List Flux task runs that occurred in a time range

```sh
curl --GET 'http://localhost:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs' \
  --header 'Content-Type: application/json' \
  --data-urlencode 'afterTime=2021-01-01T00:00:00Z' \
  --data-urlencode 'beforeTime=2021-01-31T00:00:00Z'
```

## Retry a Kapacitor Flux task run

Use the following request method and endpoint to retry a Kapacitor Flux task run.

```
POST /kapacitor/v1/api/v2/tasks/{taskID}/runs/{runID}/retry
```

Provide the following with your request (\* Required):

#### Path parameters

* \* **taskID**: Task ID
* \* **runID**: Run ID to retry

```sh
# Retry run ID XXX0xx0xX00Xx0X for task ID 000x00xX0xXXx00
curl --request POST \
  'http://localhost:9092/kapacitor/v1/api/v2/tasks/000x00xX0xXXx00/runs/XXX0xx0xX00Xx0X'
```

For an easy way to retry all failed task runs, see [Retry failed Kapacitor tasks](/kapacitor/v1/working/flux/manage/retry-failed/).

#### Related

* [Retry failed Kapacitor Flux tasks](/kapacitor/v1/working/flux/manage/retry-failed/)
* [Use Flux tasks with Kapacitor](/kapacitor/v1/working/flux/)
* [kapacitor flux task run](/kapacitor/v1/reference/cli/kapacitor/flux/task/run/)
* [kapacitor flux task run list](/kapacitor/v1/reference/cli/kapacitor/flux/task/run/list/)
* [kapacitor flux task run retry](/kapacitor/v1/reference/cli/kapacitor/flux/task/run/retry/)
* [kapacitor flux task retry-failed](/kapacitor/v1/reference/cli/kapacitor/flux/task/retry-failed/)