v3.8.2 API and CLI updates by jstirnaman · Pull Request #6774 · influxdata/docs-v2

jstirnaman · 2026-01-28T21:29:31Z

No description provided.

- Add --tls-no-verify option to CLI command docs and usage tables - Enterprise `--data-only` and `--remove-tables` flags - Parquet output

- Enterprise: Add data_only and remove_tables params to database and table delete endpoints

… tables - Add instructions for deleting only data (preserving schema and resources) for both databases and tables in InfluxDB 3 Enterprise - Update CLI and HTTP API usage examples - Clarify Parquet output instructions for database listing - Bump latest_patch to 3.9.0 for core and enterprise in products.yml

github-actions · 2026-01-28T21:31:48Z

PR Preview Action v1.4.8
🚀 Deployed preview to https://influxdata.github.io/docs-v2/pr-preview/pr-6774/
on branch `gh-pages` at 2026-01-28 21:31 UTC

github-actions · 2026-01-28T21:31:49Z

PR Preview

Status	Details
Preview	View preview
Pages	25 page(s) deployed
Build time	66s
Last updated	2026-01-28 21:31:48 UTC

Pages included in this preview

/influxdb3/enterprise/admin/databases/delete/
/influxdb3/core/admin/databases/delete/
/influxdb3/enterprise/admin/databases/list/
/influxdb3/core/admin/databases/list/
/influxdb3/enterprise/admin/tables/delete/
/influxdb3/core/admin/tables/delete/
/influxdb3/enterprise/reference/cli/influxdb3/create/database/
/influxdb3/core/reference/cli/influxdb3/create/database/
/influxdb3/enterprise/reference/cli/influxdb3/create/table/
/influxdb3/core/reference/cli/influxdb3/create/table/
/influxdb3/enterprise/reference/cli/influxdb3/create/trigger/
/influxdb3/core/reference/cli/influxdb3/create/trigger/
/influxdb3/enterprise/reference/cli/influxdb3/delete/database/
/influxdb3/core/reference/cli/influxdb3/delete/database/
/influxdb3/enterprise/reference/cli/influxdb3/delete/table/
/influxdb3/core/reference/cli/influxdb3/delete/table/
/influxdb3/enterprise/reference/cli/influxdb3/delete/token/
/influxdb3/core/reference/cli/influxdb3/delete/token/
/influxdb3/enterprise/reference/cli/influxdb3/delete/trigger/
/influxdb3/core/reference/cli/influxdb3/delete/trigger/
... and 5 more

_{Preview auto-deploys on push. Will be cleaned up when PR closes.}

hiltontj

It may be worth having a disclaimer somewhere that using --tls-no-verify is not recommended in production environments (though, it is true that it is useful for testing/development with self-signed certs, as mentioned in this change set).

Updated the latest_patch version for both core and enterprise categories from 3.9.0 to 3.8.1.

peterbarnett03 · 2026-02-23T21:16:04Z

@jstirnaman Updated one file via commit to 3.8.1 for products

hiltontj · 2026-02-23T21:37:00Z

@peterbarnett03 we are actually releasing 3.8.2, not 3.8.1, which was released on Jan 12th.

hiltontj · 2026-02-23T21:37:39Z

Though, if this only pertains to the 3.8.1 release then your change makes sense - but I reckon we need a new PR for 3.8.2?

jstirnaman · 2026-02-24T04:14:29Z

@peterbarnett03

v3.8.1 Coverage Assessment (automated source analysis)

I ran a source-level diff of influxdata/influxdb between v3.8.0 and v3.8.1 tags and compared the results against this PR. Here's the coverage matrix:

Coverage Matrix

Source Change	Priority	In PR?	Notes
`influxdb3 show retention` CLI page	HIGH	✅ Yes	`show/retention.md` present
`--tls-no-verify` on CLI commands	HIGH	⚠️ Partial	Added to ~10 pages, but ~12 more CLI pages need it (see list below)
`_internal` 7-day default retention	MEDIUM	❌ No	New default `INTERNAL_DB_RETENTION_PERIOD = 604800s` not documented
Improved error messages (resource name)	MEDIUM	❌ No	Release notes only
Prevent table deletion from deleted DB	MEDIUM	❌ No	Release notes only
Memory optimization (sparse time-series)	LOW	❌ No	Release notes only
OpenMetrics EOF on `/metrics`	LOW	❌ No	Release notes only
`INFLUXDB3_TLS_NO_VERIFY` env var reference	HIGH	❌ No	Not in env vars reference
`--tls-ca` on `plugin-test wal` (was missing)	LOW	❌ No	—
Release notes for v3.8.1	HIGH	❌ No	No release notes pages
`--tls-no-verify` safety disclaimer	—	❌ No	Per hiltontj's review comment

CLI pages missing `--tls-no-verify`

These subcommands gained --tls-no-verify in v3.8.1 source but are not updated in this PR:

influxdb3-cli/query.md
influxdb3-cli/write.md
influxdb3-cli/enable/trigger.md
influxdb3-cli/disable/trigger.md
influxdb3-cli/show/databases.md
influxdb3-cli/show/tokens.md
influxdb3-cli/show/plugins.md
influxdb3-cli/show/system/*.md
influxdb3-cli/update/database.md
influxdb3-cli/update/table.md
influxdb3-cli/test/*.md
influxdb3-cli/plugin-test/wal.md

Scope concern: v3.9.0 content mixed in

The following content in this PR is from v3.9.0 (Enterprise) and should be separated:

--data-only and --remove-tables CLI flags
data_only and remove_tables API query parameters
Data-only deletion admin docs (databases/delete.md, tables/delete.md)
API ref changes in api-docs/influxdb3/enterprise/v3/ref.yml

Recommendations

Split PR — separate v3.8.1 changes from v3.9.0 Enterprise features
Complete --tls-no-verify coverage — add to all ~12 remaining CLI pages
Add missing content — _internal retention default, env var reference, release notes, safety disclaimer
Resolve version targeting — per hiltontj's comment about v3.8.1 already being released Jan 12

Generated from source-level analysis of influxdata/influxdb v3.8.0→v3.8.1 diff. Full report: influxdb3-v3.8.1-analysis.md

- Update latest_patch to 3.8.2 for Core and Enterprise in products.yml (3.8.1 was internal-only) - Add --tls-no-verify and INFLUXDB3_TLS_NO_VERIFY env var to all remaining CLI pages (query, write, show, enable, disable, update, test, stop, create/delete cache and file_index commands) - Add safety disclaimer: "Not recommended in production" per review - Standardize --tls-ca description across all CLI pages - Add v3.8.2 release notes for Core and Enterprise Addresses review feedback from hiltontj and jstirnaman on PR #6774. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Remove all PachaTree-related content that is not yet ready for public documentation: - Remove --use-pacha-tree from Enterprise serve CLI reference - Replace influxdb3_pacha_tree log filter example with influxdb3_enterprise - Remove influxdb3_pacha_tree from component names table - Remove PachaTree storage engine entry from v3.7.0 release notes Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…atures # Conflicts: # content/influxdb3/enterprise/reference/cli/influxdb3/serve.md

jstirnaman added 3 commits January 28, 2026 14:55

feat(influxdb3): Update v3.9 CLI reference

9dfa1cf

- Add --tls-no-verify option to CLI command docs and usage tables - Enterprise `--data-only` and `--remove-tables` flags - Parquet output

feat(influxdb3): v3.9.0 API reference

0ef69d7

- Enterprise: Add data_only and remove_tables params to database and table delete endpoints

jstirnaman added this to the Core and Ent 3 next release milestone Jan 28, 2026

jstirnaman self-assigned this Jan 28, 2026

jstirnaman requested review from a team, garylfowler and peterbarnett03 as code owners January 28, 2026 21:29

jstirnaman added the InfluxDB 3 Core and Enterprise label Jan 28, 2026

jstirnaman requested review from sanderson and removed request for a team and garylfowler January 28, 2026 21:29

hiltontj approved these changes Jan 30, 2026

View reviewed changes

jstirnaman added the hold off Should not be merged or address yet label Jan 30, 2026

jstirnaman marked this pull request as draft February 4, 2026 22:48

jstirnaman changed the title ~~v3.9.0 API and CLI updates~~ v3.8.1 API and CLI updates Feb 10, 2026

jstirnaman changed the base branch from release/influxdb3.9 to release/3.8.1 February 19, 2026 16:57

fix: Change latest_patch version to 3.8.1

b128c05

Updated the latest_patch version for both core and enterprise categories from 3.9.0 to 3.8.1.

peterbarnett03 and others added 2 commits February 24, 2026 15:52

peterbarnett03 changed the title ~~v3.8.1 API and CLI updates~~ v3.8.2 API and CLI updates Feb 24, 2026

peterbarnett03 changed the base branch from release/3.8.1 to master February 24, 2026 20:59

Merge remote-tracking branch 'origin/master' into jts-influxdb-3-9-fe…

04af773

…atures # Conflicts: # content/influxdb3/enterprise/reference/cli/influxdb3/serve.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

v3.8.2 API and CLI updates#6774

v3.8.2 API and CLI updates#6774
jstirnaman wants to merge 7 commits intomasterfrom
jts-influxdb-3-9-features

jstirnaman commented Jan 28, 2026

Uh oh!

github-actions bot commented Jan 28, 2026

Uh oh!

github-actions bot commented Jan 28, 2026

Uh oh!

hiltontj left a comment

Uh oh!

peterbarnett03 commented Feb 23, 2026

Uh oh!

hiltontj commented Feb 23, 2026

Uh oh!

hiltontj commented Feb 23, 2026

Uh oh!

jstirnaman commented Feb 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Comments

Conversation

jstirnaman commented Jan 28, 2026

Uh oh!

github-actions bot commented Jan 28, 2026

Uh oh!

github-actions bot commented Jan 28, 2026

PR Preview

Uh oh!

hiltontj left a comment

Choose a reason for hiding this comment

Uh oh!

peterbarnett03 commented Feb 23, 2026

Uh oh!

hiltontj commented Feb 23, 2026

Uh oh!

hiltontj commented Feb 23, 2026

Uh oh!

jstirnaman commented Feb 24, 2026

v3.8.1 Coverage Assessment (automated source analysis)

Coverage Matrix

CLI pages missing --tls-no-verify

Scope concern: v3.9.0 content mixed in

Recommendations

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

CLI pages missing `--tls-no-verify`