---
title: influxdb3 update trigger
description: The influxdb3 update trigger command updates an existing trigger.
url: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/update/trigger/
estimated_tokens: 2082
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/update/trigger/
date: '2026-07-11T10:53:18+00:00'
lastmod: '2026-07-11T10:53:18+00:00'
---

The `influxdb3 update trigger` command updates an existing trigger in your InfluxDB 3 Enterprise instance.

Use this command to update trigger plugin code, configuration, or behavior without recreating the trigger. This preserves trigger history and configuration while allowing you to iterate on plugin development.

> [!Important]
> `influxdb3 update trigger` does not work with triggers that reference plugins using the `gh:` prefix.
> To fetch updated code for a `gh:` trigger, [disable and re-enable the trigger](#update-a-gh-trigger).

## Usage

```bash
influxdb3 update trigger [OPTIONS] \
  --database <DATABASE_NAME> \
  --trigger-name <TRIGGER_NAME>
```

## Arguments

* **`DATABASE_NAME`**: (Required) The name of the database containing the trigger.
* **`TRIGGER_NAME`**: (Required) The name of the trigger to update.

## Options

|Option|                     |                                                       Description                                                       |
|------|---------------------|-------------------------------------------------------------------------------------------------------------------------|
| `-H` |      `--host`       |                Host URL of the running InfluxDB 3 Enterprise server (default is `http://127.0.0.1:8181`)                |
| `-d` |    `--database`     |                                *(Required)* Name of the database containing the trigger                                 |
|      |  `--trigger-name`   |                                       *(Required)* Name of the trigger to update                                        |
| `-p` |      `--path`       |Local path to a plugin file or directory (single `.py` file or directory containing `__init__.py` for multifile plugins).|
|      |`--trigger-arguments`|Additional arguments for the trigger, in the format `key=value`, separated by commas (for example, `arg1=val1,arg2=val2`)|
|      |    `--disabled`     |                                            Set the trigger state to disabled                                            |
|      |     `--enabled`     |                                            Set the trigger state to enabled                                             |
|      | `--error-behavior`  |                                  Error handling behavior: `log`, `retry`, or `disable`                                  |
|      |      `--token`      |                                                  Authentication token                                                   |
|      |     `--tls-ca`      |                  Path to a custom TLS certificate authority (for testing or self-signed certificates)                   |
|      |  `--tls-no-verify`  |      Disable TLS certificate verification (**Not recommended in production**, useful for self-signed certificates)      |
| `-h` |      `--help`       |                                                 Print help information                                                  |
|      |    `--help-all`     |                                             Print detailed help information                                             |

### Option environment variables

You can use the following environment variables instead of providing CLI options directly:

|  Environment Variable   |     Option      |
|-------------------------|-----------------|
|  `INFLUXDB3_HOST_URL`   |    `--host`     |
|`INFLUXDB3_DATABASE_NAME`|  `--database`   |
| `INFLUXDB3_AUTH_TOKEN`  |    `--token`    |
|   `INFLUXDB3_TLS_CA`    |   `--tls-ca`    |
|`INFLUXDB3_TLS_NO_VERIFY`|`--tls-no-verify`|

## Examples

The following examples show how to update triggers in different scenarios.

* [Update trigger plugin code](#update-trigger-plugin-code)
* [Upload and update with a local plugin](#upload-and-update-with-a-local-plugin)
* [Update a gh: trigger](#update-a-gh-trigger)
* [Update trigger arguments](#update-trigger-arguments)
* [Enable or disable a trigger](#enable-or-disable-a-trigger)
* [Update error handling behavior](#update-error-handling-behavior)

Replace the following placeholders with your values:

* `DATABASE_NAME`: Database name
* `AUTH_TOKEN`: Authentication token
* `TRIGGER_NAME`: Name of the trigger to update

### Update trigger plugin code

Update a trigger with modified plugin code from a local file.
The command transfers the file to the server and requires an admin token.

```bash
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --path "my_plugin.py" \
  --token AUTH_TOKEN
```

### Upload and update with a local plugin

Upload new plugin code from your local machine and update the trigger in a single operation. Requires admin token.

```bash
# Upload single-file plugin
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --path "/local/path/to/updated_plugin.py" \
  --token AUTH_TOKEN

# Upload multifile plugin directory
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --path "/local/path/to/plugin_directory" \
  --token AUTH_TOKEN
```

The command transfers local files to the server’s plugin directory.

### Update a gh: trigger

For a trigger that references a plugin with the `gh:` prefix, publish your changes at the configured plugin source, then disable and re-enable the trigger to fetch the updated code.
Use the dedicated `disable trigger` and `enable trigger` commands.

```bash
influxdb3 disable trigger \
  --database DATABASE_NAME \
  --token AUTH_TOKEN \
  TRIGGER_NAME

influxdb3 enable trigger \
  --database DATABASE_NAME \
  --token AUTH_TOKEN \
  TRIGGER_NAME
```

### Update trigger arguments

Modify the arguments passed to a trigger’s plugin code.

```bash
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --trigger-arguments threshold=100,window=5m \
  --token AUTH_TOKEN
```

### Enable or disable a trigger

Change the trigger’s enabled state without modifying other configuration.

```bash
# Disable a trigger
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --disabled \
  --token AUTH_TOKEN

# Enable a trigger
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --enabled \
  --token AUTH_TOKEN
```

### Update error handling behavior

Change how the trigger responds to errors.

```bash
# Log errors without retrying
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --error-behavior log \
  --token AUTH_TOKEN

# Retry on errors
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --error-behavior retry \
  --token AUTH_TOKEN

# Disable trigger on error
influxdb3 update trigger \
  --database DATABASE_NAME \
  --trigger-name TRIGGER_NAME \
  --error-behavior disable \
  --token AUTH_TOKEN
```
| Option |  | Description |
| --- | --- | --- |
| Option |  | Description |
| -H | --host | Host URL of the running InfluxDB 3 Enterprise server (default is  http://127.0.0.1:8181 ) |
| -d | --database | ( Required )  Name of the database containing the trigger |
|  | --trigger-name | ( Required )  Name of the trigger to update |
| -p | --path | Local path to a plugin file or directory (single  .py  file or directory containing  __init__.py  for multifile plugins). |
|  | --trigger-arguments | Additional arguments for the trigger, in the format  key=value , separated by commas (for example,  arg1=val1,arg2=val2 ) |
|  | --disabled | Set the trigger state to disabled |
|  | --enabled | Set the trigger state to enabled |
|  | --error-behavior | Error handling behavior:  log ,  retry , or  disable |
|  | --token | Authentication token |
|  | --tls-ca | Path to a custom TLS certificate authority (for testing or self-signed certificates) |
|  | --tls-no-verify | Disable TLS certificate verification ( Not recommended in production , useful for self-signed certificates) |
| -h | --help | Print help information |
|  | --help-all | Print detailed help information |

| Environment Variable | Option |
| --- | --- |
| Environment Variable | Option |
| INFLUXDB3_HOST_URL | --host |
| INFLUXDB3_DATABASE_NAME | --database |
| INFLUXDB3_AUTH_TOKEN | --token |
| INFLUXDB3_TLS_CA | --tls-ca |
| INFLUXDB3_TLS_NO_VERIFY | --tls-no-verify |
