--- title: influx delete description: The influx delete command deletes points from an InfluxDB bucket. url: https://docs.influxdata.com/influxdb/cloud/reference/cli/influx/delete/ estimated_tokens: 1923 product: InfluxDB Cloud (TSM) version: cloud publisher: InfluxData canonical: https://docs.influxdata.com/influxdb/cloud/reference/cli/influx/delete/ date: '2025-04-02T15:54:32-06:00' lastmod: '2025-04-02T15:54:32-06:00' --- * influx CLI 2.0.3+ * Updated in CLI v2.2.0 The `influx delete` command deletes [points](/influxdb/cloud/reference/glossary/#point)from an InfluxDB bucket in a specified time range. Select points to delete within the specified time range using [delete predicate syntax](/influxdb/cloud/reference/syntax/delete-predicate). #### Deleting data without a delete predicate Running `influx delete` without the `-p` or `--predicate` flag deletes all data with timestamps between the specified`--start` and `--stop` times in the specified bucket. ## Flags |Flag| | Description |Input type|Maps to [?](/influxdb/cloud/reference/cli/influx/#view-mapped-environment-variables)| |----|-----------------|----------------------------------------------------------------------------------------------------------|----------|------------------------------------------------------------------------------------| |`-c`|`--active-config`| CLI configuration to use for command | string | | |`-b`| `--bucket` | Name of bucket to remove data from (mutually exclusive with `--bucket-id`) | string | `INFLUX_BUCKET_NAME` | | | `--bucket-id` | Bucket ID (mutually exclusive with `--bucket`) | string | `INFLUX_BUCKET_ID` | | |`--configs-path` | Path to `influx` CLI configurations (default `~/.influxdbv2/configs`) | string | `INFLUX_CONFIGS_PATH` | |`-h`| `--help` | Help for the `delete` command | | | | | `--host` | HTTP address of InfluxDB (default `http://localhost:8086`) | string | `INFLUX_HOST` | | | `--http-debug` | Inspect communication with InfluxDB servers. | string | | |`-o`| `--org` | Organization name (mutually exclusive with `--org-id`) | string | `INFLUX_ORG` | | | `--org-id` | Organization ID (mutually exclusive with `--org`) | string | `INFLUX_ORG_ID` | |`-p`| `--predicate` |InfluxQL-like predicate string (see [Delete predicate](/influxdb/cloud/reference/syntax/delete-predicate))| string | | | | `--skip-verify` | Skip TLS certificate verification | | `INFLUX_SKIP_VERIFY` | | | `--start` | (Required) Start time in RFC3339 format (i.e. `2009-01-02T23:00:00Z`) | string | | | | `--stop` | (Required) Stop time in RFC3339 format (i.e. `2009-01-02T23:00:00Z`) | string | | |`-t`| `--token` | API token | string | `INFLUX_TOKEN` | ## Examples #### 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 * [Delete all points in a measurement](#delete-all-points-in-a-measurement) * [Delete points in a measurement with a specific tag value](#delete-points-in-a-measurement-with-a-specific-tag-value) * [Delete all points within a specified time frame](#delete-all-points-within-a-specified-time-frame) ##### Delete all points in a measurement ```sh influx delete \ --bucket example-bucket \ --start 1970-01-01T00:00:00Z \ --stop $(date -u +"%Y-%m-%dT%H:%M:%SZ") \ --predicate '_measurement="example-measurement"' ``` ##### Delete points in a measurement with a specific tag value ```sh influx delete \ --bucket example-bucket \ --start 1970-01-01T00:00:00Z \ --stop $(date -u +"%Y-%m-%dT%H:%M:%SZ") \ --predicate '_measurement="example-measurement" AND host="old-host"' ``` ##### Delete all points within a specified time frame ```sh influx delete \ --bucket example-bucket \ --start 2020-03-01T00:00:00Z \ --stop 2020-11-14T00:00:00Z ``` #### Related * [Delete data](/influxdb/cloud/write-data/delete-data/) * [Delete predicate syntax](/influxdb/cloud/reference/syntax/delete-predicate/) * [influx CLI—Provide required authentication credentials](/influxdb/cloud/reference/cli/influx/#provide-required-authentication-credentials) * [influx CLI—Flag patterns and conventions](/influxdb/cloud/reference/cli/influx/#flag-patterns-and-conventions) [delete](/influxdb/cloud/tags/delete/) | Flag | | Description | Input type | Maps to ? | | --- | --- | --- | --- | --- | | Flag | | Description | Input type | Maps to ? | | -c | --active-config | CLI configuration to use for command | string | | | -b | --bucket | Name of bucket to remove data from (mutually exclusive with --bucket-id ) | string | INFLUX_BUCKET_NAME | | | --bucket-id | Bucket ID (mutually exclusive with --bucket ) | string | INFLUX_BUCKET_ID | | | --configs-path | Path to influx CLI configurations (default ~/.influxdbv2/configs ) | string | INFLUX_CONFIGS_PATH | | -h | --help | Help for the delete command | | | | | --host | HTTP address of InfluxDB (default http://localhost:8086 ) | string | INFLUX_HOST | | | --http-debug | Inspect communication with InfluxDB servers. | string | | | -o | --org | Organization name (mutually exclusive with --org-id ) | string | INFLUX_ORG | | | --org-id | Organization ID (mutually exclusive with --org ) | string | INFLUX_ORG_ID | | -p | --predicate | InfluxQL-like predicate string (see Delete predicate ) | string | | | | --skip-verify | Skip TLS certificate verification | | INFLUX_SKIP_VERIFY | | | --start | ( Required ) Start time in RFC3339 format (i.e. 2009-01-02T23:00:00Z ) | string | | | | --stop | ( Required ) Stop time in RFC3339 format (i.e. 2009-01-02T23:00:00Z ) | string | | | -t | --token | API token | string | INFLUX_TOKEN |