Confluent CLI Release Notes
Note that the Confluent CLI is continuously updated with improvements and new features. This page highlights significant user-facing features and updates to the interface.
[1/4/2024] Confluent CLI v3.46.0 Release Notes
New Features
- Add - confluent kafka mirror reverse-and-start
- Add - confluent kafka mirror reverse-and-pause
[12/15/2023] Confluent CLI v3.45.0 Release Notes
New Features
- [Early Access] Create Flink API keys with - confluent api-key create --resource flink --cloud <cloud> --region <region>
- [Early Access] Full Flink SQL autocomplete for - confluent flink shell
- [Early Access] Add “Environment” field to the output of the - confluent flink compute-poolcommands
- [Early Access] Support - Alt + Enterin- confluent flink shellto trigger statement submission without needing to suffix the statement with a semicolon
- [Early Access] Support - Alt + Backspacein- confluent flink shellto delete the previous word
- Add - confluent networkcommands for managing networking resources in Confluent Cloud
- Add the - --networkflag to- confluent kafka cluster create,- confluent kafka cluster describe, and- confluent kafka cluster listcommands
Bug Fixes
- Fix panic in - confluent schema-registry schema describe
[12/6/2023] Confluent CLI v3.44.0 Release Notes
New Features
- [Early Access] Add “Cloud” to the output of the confluent flink compute-pool commands 
Bug Fixes
- Fix a - 401 Unauthorizedbug for Confluent Platform- confluent schema-registrycommands
- Fix “REQUIRED” annotations and logic in - confluent shell
[12/4/2023] Confluent CLI v3.43.0 Release Notes
New Features
- Add GCP support in - confluent byokcommands for customer-managed keys in Confluent Cloud
- Removed - --encryption-keyin- confluent kafka cluster createin favor of the- --byokflag, which can be used to pass the ID of a customer-managed key when creating BYOK Kafka clusters in Confluent Cloud
- [Limited Availability] Added - confluent iam ip-groupand- confluent iam ip-filtercommands
Bug Fixes
- Fixed a panic in - confluent kafka topic consumewhen user is not logged in
[11/16/2023] Confluent CLI v3.42.0 Release Notes
New Features
- Display replication factor and partition count in - confluent kafka topic list
- Users can run - confluent kafka topic produceand- confluent kafka topic consumewhen not logged in to Confluent Cloud by passing in- --bootstrap,- --api-keyand- --api-secret
Bug Fixes
- Fix panic in - confluent kafka topic produce
[11/9/2023] Confluent CLI v3.41.0 Release Notes
New Features
- Multiline support for - confluent feedback
Bug Fixes
- Resolved the “no such host” error when running - confluent local kafka startwith the latest version of Docker
- Fix panic during HTTP retry 
[11/2/2023] Confluent CLI v3.40.0 Release Notes
New Features
- Support - --value-format doublein- confluent kafka topic produceand- confluent kafka topic consume
Bug Fixes
- Refresh authentication token on HTTP retry, if needed 
[10/19/2023] Confluent CLI v3.39.0 Release Notes
New Features
- General updates and improvements 
[10/12/2023] Confluent CLI v3.38.0 Release Notes
New Features
- Add - --print-offsetto- confluent kafka topic consumefor printing the partition number and offset of each message
[10/5/2023] Confluent CLI v3.37.0 Release Notes
New Features
- Optionally enable text highlighting with - confluent configuration update enable_color true
- Improve - confluent asyncapi importoutput
- Improve - confluent kafka topic describeoutput for Confluent Platform
Bug Fixes
- Resolve an issue causing - confluent kafka topic produceto fail when using schema-based key formats with some delimiter choices
[9/28/2023] Confluent CLI v3.36.0 Release Notes
New Features
- Add - confluent kafka consumer group lagcommands
[9/25/2023] Confluent CLI v3.35.0 Release Notes
New Features
- Add - confluent kafka consumer group describe
- Add - confluent kafka consumer group list
- Add - confluent kafka consumer list
Bug Fixes
- Correctly format timestamps in YAML output 
[9/21/2023] Confluent CLI v3.34.0 Release Notes
New Features
- If available, display RBAC role binding ID in - confluent iam rbac role-bindingcommands
- Add - confluent kafka partition describeand- confluent kafka partition listcloud commands
Bug Fixes
- Add the missing - --outputflag to- confluent kafka link describeand remove the unused- --forceflag
- Verify Java version at the beginning when running - confluent local services start
[9/14/2023] Confluent CLI v3.33.0 Release Notes
New Features
- Added - confluent connect custom-plugincommands
Bug Fixes
- Fix a bug in context decryption after running - confluent context update --name
- Fix a bug where custom connectors no longer require “connector.class” in - confluent connect cluster create
- Fix a panic that occurs when using - confluent kafka topic consume --key-formatwith a schema-based key format
[9/7/2023] Confluent CLI v3.32.0 Release Notes
New Features
- Add - --jit-enabledto allow customer to toggle the JUST-IN-TIME for SSO enabled organization
- Add - --brokersflag in- confluent local kafka startto allow starting a multi-broker Confluent Local instance
- Add - confluent local kafka brokercommand
- Add - confluent local kafka cluster configurationcommand
Bug Fixes
- Fix a bug in - confluent iam user invitation listwhere only the first 100 results were listed
- Fix an issue causing - confluent kafka topic consumeto deserialize integers to incorrect values when using- --key-format integeror- value-format integer
- Resolve a panic that could occur in - confluent kafka topic consumewhen using- --key-format integerand- --print-key
- --parse-keymust now be specified when using- confluent kafka topic produce --key-format
[9/5/2023] Confluent CLI v3.31.0 Release Notes
New Features
- Add - confluent iam service-account useand- confluent iam service-account unset
Bug Fixes
- Fix an incorrect URL causing - confluent plugin searchand- confluent plugin installto fail
[8/24/2023] Confluent CLI v3.30.0 Release Notes
New Features
- Add support for multiple arguments to - deletecommands
Bug Fixes
- Resolve a panic in - confluent iam rbac role-binding list
- After session has timed out, correctly refresh credentials with environment variables or credentials saved with - confluent login --save
[8/17/2023] Confluent CLI v3.29.0 Release Notes
New Features
- Add - --allto- confluent kafka acl listto include deleted ACLs whose principals are integer IDs
- Add - confluent configurationcommands for configuration file management
- Add - confluent schema-registry config deletecommand
Bug Fixes
- Fix a flaky panic that occurred when pressing Ctrl-C in - confluent kafka topic produce
- Fix a panic that occurred when - /dev/ttywas inaccessible in- confluent flink shell
[8/11/2023] Confluent CLI v3.28.0 Release Notes
New Features
- confluent local servicescommands were dropped from v3.16.0 to v3.26.0, but are back as of v3.27.0 and will be supported until the next major version release (v4.0.0). These will be replaced by faster comparable commands with the syntax- confluent local <name-of-service>. The first of these,- confluent local kafka, is already present in the CLI.
- Add support for both strings and files for the - --configflag, in all relevant- confluent kafkaand- confluent schema-registrycommands
- Support - --key-format integerand- --value-format integerin- confluent kafka topic produceand- confluent kafka topic consume
Bug Fixes
- Resolve a panic that can happen when exiting - confluent kafka topic producewith Ctrl-C on Windows
- confluent kafka topic consume --groupwill start consuming from the offset that it exited with last time
- Prevent errors for certain statuses in - confluent kafka mirror describeand- confluent kafka mirror list
[8/7/2023] Confluent CLI v3.27.0 Release Notes
New Features
- Support - --protocol PLAINTEXTin- confluent kafka topic consume
- Enable Schema Registry to be used without authentication on-premises, for the purpose of demos 
Bug Fixes
- Fix authentication issue in - confluent kafka topic [produce | consume]on Windows
- Fix panic in - confluent api-key store --resource
- Prevent “flag accessed but not defined” error in - confluent schema-registrycommands
[8/3/2023] Confluent CLI v3.26.0 Release Notes
New Features
- Add - --key-format,- --key-schema, and- --key-referencesto- kafka topic produce
- Add - --key-formatto- kafka topic consume
- Suggest updating with - brew upgradeif installed with Homebrew
[7/27/2023] Confluent CLI v3.25.0 Release Notes
New Features
- Add - confluent feedbackfor user-submitted feedback
- When authenticated with Confluent Cloud, no longer require an API key for Schema Registry operations 
- Add - confluent kafka cluster configurationcommands for managing dedicated cluster configurations
Bug Fixes
- Correctly display Confluent Platform mirror topics in - confluent kafka link list --include-topics
- Fix - confluent asyncapi importand- confluent asyncapi exportto follow AsyncAPI documentation for Kafka channel bindings, with explicit fields for- bindingVersion,- partitions, and- topicConfiguration
- Improve error message when no API secret is provided to - confluent kafka client-config create
[7/21/2023] Confluent CLI v3.24.0 Release Notes
New Features
- Allow changing default port numbers in - confluent local kafka startwith the- --kafka-rest-portand- --plaintext-portflags
- Print progress while downloading Docker image in - confluent local kafka start
- Print the ports that Confluent Local is using when running - confluent local kafka start
- Autocomplete flags in - confluent kafka client-config createcommands
- Add autocompletion to - confluent kafka topic produceand- confluent kafka topic consume
- List and install plugins from the official Confluent CLI plugin repository with - confluent plugin searchand- confluent plugin install
Bug Fixes
- Fix autocompletion of - --availabilityand- --typeflags in- confluent kafka cluster create
[7/14/2023] Confluent CLI v3.23.0 Release Notes
New Features
- Add a suggestion to use - confluent kafka clusterwhen users run the on-premises- confluent clustercommand while logged in to Confluent Cloud
- Support passing schema IDs to the - --schemaflag in- confluent kafka topic produce
[7/13/2023] Confluent CLI v3.22.0 Release Notes
New Features
- Improve the error message when a user runs an on-premises command while logged into Confluent Cloud 
- Bidirectional link support for - confluent kafka link
- No longer require passing the - --resourceflag to- confluent api-key use
Bug Fixes
- Prevent a panic when passing a non-existent Kafka cluster to - confluent api-key store --resource
- Fix “type” output in - confluent schema-registry schema describeand properly format Avro schemas
- Print an error message when - confluent local kafka startis run from an AMD64 binary on an ARM64 machine
[7/6/2023] Confluent CLI v3.21.0 Release Notes
New Features
- Add - confluent pipeline create --use-schema-registry, and by default do not add Schema Registry to pipelines
Bug Fixes
- Fix misleading error messages in - confluent kafka topic consume
[6/29/2023] Confluent CLI v3.20.0 Release Notes
New Features
- Autocompletion for - confluent api-key create --resource
- Add - confluent kafka link describe
Bug Fixes
- Fixes the 404 error when creating a role binding attached to an identity pool 
[6/23/2023] Confluent CLI v3.19.0 Release Notes
New Features
- Encrypt API key pair in context credentials 
Bug Fixes
- Fix permission issue while running - confluent updatein Docker image
[6/15/2023] Confluent CLI v3.18.0 Release Notes
New Features
- Add - confluent connect plugin installcommand to install Connect plugins for Confluent Platform
- Support calling - confluent environment describewithout arguments
- Autocomplete arguments in - confluent service-quota list
Bug Fixes
- Prevent panic while retrieving Schema Registry cluster information 
[6/8/2023] Confluent CLI v3.17.0 Release Notes
New Features
- Add - confluent billing cost list
Bug Fixes
- Fix - confluent updatechecksum validation for Alpine Linux
[6/2/2023] Confluent CLI v3.16.0 Release Notes
New Features
- Added new Docker-based - confluent localcommands for improved local testing of Confluent Platform
Bug Fixes
- Removed unused - --outputflag in- confluent kafka topic consume
[5/25/2023] Confluent CLI v3.15.0 Release Notes
New Features
- Support topic prefixes ending with a wildcard (*) in - confluent asyncapi export --topics
- Update “num.partitions” for a Kafka topic with - confluent kafka topic update --config
[5/18/2023] Confluent CLI v3.14.0 Release Notes
New Features
- Publish with Homebrew 
- Add - --metadataand- --rulesetto- confluent schema-registry schema create
- Add - --compatibility-group,- --metadata-defaults,- --metadata-overrides,- --ruleset-defaults, and- --ruleset-overridesto- confluent schema-registry subject update
Bug Fixes
- Fix decryption error when running non-authenticated commands 
- Correctly display mirror topics in - confluent kafka link list --include-topics
[5/12/2023] Confluent CLI v3.13.0 Release Notes
New Features
- Publish linux/arm64 Docker image 
Bug Fixes
- Allow plugins whose filepath starts with - ~to run
- Fix service account error in - confluent api-key createwhen audit logs are disabled
[5/4/2023] Confluent CLI v3.12.0 Release Notes
- New Features
- Add - --topicsflag to- confluent asyncapi exportto only export specified topics
 
[4/28/2023] Confluent CLI v3.11.0 Release Notes
- New Features
- Add a new - --allflag to- confluent schema-registry schema listto include soft-deleted schemas in the output
 
- Bug Fixes
- Schemas can now be permanently deleted with - confluent schema-registry schema deletewhen using- --version all
 
[4/13/2023] Confluent CLI v3.10.0 Release Notes
- New Features
- Add argument autocompletion for - confluent iam,- confluent kafka, and- confluent pipelinecommands
- Support for topic partition count in - confluent asyncapi export
- Add - --contextflag to all- confluent environmentsubcommands
 
- Bug Fixes
- Display a warning instead of an error if the topic count is not found in - confluent kafka cluster describe
- Allow more than 10 KSQL clusters to be listed in - confluent ksql cluster list
 
[4/7/2023] Confluent CLI v3.9.0 Release Notes
- New Features
- Add argument autocompletion for - confluent api-key describe
- Add support for autocompleting multiple arguments for - confluent connect cluster pauseand- confluent connect cluster resume
- Add - --ksql-clusterand- --update-schema-registryto- confluent pipeline update
 
[3/31/2023] Confluent CLI v3.8.0 Release Notes
- New Features
- Add - confluent schema-registry region listcommand
 
- Bug Fixes
- Fix a bug on Windows preventing decryption of authentication tokens 
- Fix - confluent updatefor Windows
 
[3/30/2023] Confluent CLI v3.7.0 Release Notes
- New Features
- Add - confluent asyncapi importcommand
- Add suggestions to check CLI’s access to - /etcwhen encryption fails
- Improve documentation for - confluent iam aclcommands
 
- Bug Fixes
- Correct filename autocompletion for - avscfiles
 
[3/23/2023] Confluent CLI v3.6.0 Release Notes
- New Features
- When specifying a file with a flag, auto-complete according to file extension 
 
- Bug Fixes
- Prevent panics in - confluent kafka cluster useand- confluent api-keycommands for users without an environment
- Fixed a decryption error when running - confluent context listwith old contexts from- ~/.confluent/config.json
 
[3/17/2023] Confluent CLI v3.5.2 Release Notes
- Bug Fixes
- Prevent a panic that could occur in various - confluent api-keycommands
 
[3/16/2023] Confluent CLI v3.5.1 Release Notes
- Bug Fixes
- Fix an issue where - confluent schema-registry schema delete --permanentprevents permanent deletion of schema versions
- Allow - confluent kafka topic produceto run when using a context created with- confluent context create
- Ignore Protobuf schemas in - confluent asyncapi export
- Correctly propagate backend errors in - confluent kafka quota list
- Allow primitive Avro schemas in - confluent asyncapi export
 
[3/7/2023] Confluent CLI v3.5.0 Release Notes
- New Features
- Add - confluent organization describe,- list, and- update
 
- Bug Fixes
- Disable plugins by default on Windows, but allow manual re-enablement in - ~/.confluent/config.json
- Fix - cipher: message authentication failedissue on Alpine image
 
[3/2/2023] Confluent CLI v3.4.0 Release Notes
- New Features
- Format JSON output in - confluent schema-registry schema describe
- Add the - --useflag to- confluent api-key createto select an API key after it has been created
- Add - jqto Docker image
- Update description of - confluent login --saveto mention that credentials will also be saved to keychain on macOS
- Improve error messages for when a Kafka cluster is deleted from outside of the CLI 
- Display a warning message when a command requires an active environment, but no environment is selected 
 
- Bug Fixes
- Ignore the “Current” column when sorting the output of - listcommands
- Prevent empty flag values from being passed in - confluent price list
- Validate nonce length to avoid a panic while encrypting or decrypting login credentials 
- Prevent a panic that could occur when using commands with the - --environmentflag
- Fix examples for on-prem - confluent kafka acl create
- Use - $PATHEXTto correctly determine if a plugin is executable on Windows
 
[2/23/2023] Confluent CLI v3.3.0 Release Notes
- New Features
- Add - confluent byok(Bring Your Own Key) commands for customer-managed keys in Confluent Cloud
 
- Bug Fixes
- Resolve a panic that could occur in - confluent api-key list
 
[2/21/2023] Confluent CLI v3.2.1 Release Notes
- Bug Fixes
- Fix a panic that could occur in - confluent asyncapi exportwhen using protobuf schemas
- Fix an issue preventing users from successfully using - confluent loginin a Docker container
- Fix a panic that could occur in - confluent schema-registry cluster describe
- Update ingress/egress limits to correct values in - confluent kafka cluster describe
 
[2/17/2023] Confluent CLI v3.2.0 Release Notes
- Breaking Changes
- Confluent Cloud sign-up in the CLI has been removed. - confluent cloud-signupnow opens the sign-up page in the user’s browser
 
- New Features
- Encrypt authenticated context and login credentials on local storage 
 
- Bug Fixes
- Fixed an issue in - confluent api-key list. Users with DeveloperRead/Write/Manage roles can list API keys to which they have access.
- The Kafka cluster name is not updated when it’s not specified in - confluent kafka cluster update
 
[2/9/2023] Confluent CLI v3.1.1 Release Notes
- Bug Fixes
- Fix panic in - confluent kafka link list
- Fix inefficiencies while searching - $PATHfor plugins
- Standardize flag value format across all examples 
 
[2/3/2023] Confluent CLI v3.1.0 Release Notes
- New Features
- confluent plugin listwill now display an error if plugins are disabled
- Add informative examples of the - --inclusiveflag in- confluent iam rbac role-binding list
 
- Bug Fixes
- Fix an issue causing - confluent iam rbac role-binding createto display an error despite successfully creating the role-binding when the principal is a service account
 
[1/31/2023] Confluent CLI v3.0.1 Release Notes
- Bug Fixes
- Fix a bug causing the “Activation Privilege” field to always show “false” in the output of - confluent pipelinecommands
- Fix issues in - confluent iam rbac role-binding listwhich could cause a “400 Bad Request” error when listing role bindings for a service account
- Various updates to the formatting of error messages and examples 
 
[1/25/2023] Confluent CLI v3.0.0 Release Notes
Confluent CLI is now source-available under the Confluent Community License. For more details, check out the Announcing the Source Available Confluent CLI blog post.
- Breaking Changes
- Default to HTTPS for on-prem login with - confluent login
- Require acknowledgment before deleting any resource, and use - --forceflag to skip acknowledgment
- Use correct and consistent JSON and YAML formatting across all commands 
- Remove leading “v” from archive names, so the format matches binary names 
- Place asterisk in “Current” column in - confluent api-key list,- confluent environment list, and- confluent kafka list
- Delete - confluent ksql appcommands in favor of- confluent ksql clustercommands
- In - confluent iam rbac role-binding list, combine “Service Name” and “Pool Name” into “Name”
- In - confluent iam rbac role-binding list, require the- --inclusiveflag to list role bindings in nested scopes
- Move Connect cluster management commands under - confluent connect cluster
- Prevent using numeric IDs for - confluent kafka aclcommands
- Print a table instead of a list in - confluent schema-registry compatibility validateand- confluent schema-registry config describe
- Remove the “KAPI” field, “API Endpoint” field, and the corresponding - --allflag from- confluent kafka cluster describe
- Remove shorthand flags: - -D,- -P,- -r,- -S, and- -V
- Rename “Exporter” to “exporter” in serialized output for - confluent schema-registry exporter list
- Rename “task” to “tasks” in - confluent connect cluster describe
- Rename - --current-envto- --current-environment
- Rename - --no-authto- --no-authentication
- Rename - --operationto- --operationswhere appropriate
- Rename - --refsto- --references
- Rename - --show-refsto- --show-references
- Rename - --sr-apikeyand- --sr-api-keyto- --schema-registry-api-key
- Rename - --sr-apisecretand- --sr-api-secretto- --schema-registry-api-secret
- Rename - --sr-endpointto- --schema-registry-endpoint
- Rename - confluent audit-log migrate configto- confluent audit-log config migrate
- Rename - confluent kafka link describeto- confluent kafka link configuration list
- Rename - confluent kafka partition get-reassignmentsto- confluent kafka partition reassigments list
- Rename values for - confluent price list --cluster-type
- Replace all instances of “First Name” and “Last Name” with “Full Name” 
- Require - --environmentin- confluent schema-registry cluster delete
 
- New Features
- Use Kafka REST for all - confluent kafkacommands
- Remove login requirement for - confluent secretcommands
- Add “Read Only” column to - confluent kafka topic describe
- Add detailed Kafka REST examples for - confluent kafka aclcommands
 
[5/17/2023] Confluent CLI v2.38.1 Release Notes
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage 
 
[1/12/2023] Confluent CLI v2.38.0 Release Notes
- New Features
- Add - --activation-privilegeflag to- confluent pipeline update
- Add “Secret Names” field to - confluent pipelinecommands
- Improve examples for - confluent iam rbac role-binding create
 
[12/15/2022] Confluent CLI v2.37.0 Release Notes
- New Features
- Add - --ksql-clusterflag in- confluent iam role-bindingand- confluent iam role
 
- Bug Fixes
- Resolve panic when logging in to Confluent Cloud without a valid role binding or environment 
- Print missing “KafkaRestProduce” metric in - confluent price list
 
[12/8/2022] Confluent CLI v2.36.0 Release Notes
- New Features
- Add - --schema-registry-cluster-idto- confluent iam rbac role-bindingcommands
- Add “Free Schemas Limit” field to - confluent schema-registry cluster describe
 
[12/2/2022] Confluent CLI v2.35.0 Release Notes
- New Features
- Add a - disable_feature_flagsoption to the configuration file
 
- Bug Fixes
- Fix an issue in - confluent asyncapi exportwhich could cause repeated topic descriptions
 
[11/29/2022] Confluent CLI v2.34.0 Release Notes
- New Features
- Add warning about required privileges to - confluent ksql cluster create
- Update on-prem examples for - confluent kafka topiccommands
 
- Bug Fixes
- Fix a bug causing repeated tags in - confluent asyncapi export
- Fix bug in - confluent iam rbac role-binding createthat could prevent creation when using the- --resourceflag
- Fix empty list bug in - confluent iam rbac role-binding listwhen using the- --resourceflag
 
[11/17/2022] Confluent CLI v2.33.0 Release Notes
- New Features
- Export AsyncAPI specification files with - confluent asyncapi export
 
- Bug Fixes
- Show logical KSQL cluster IDs in - confluent iam rbac role-binding list
- Fix HTTP status code error in - confluent ksql cluster configure-acls
- Fix 0 partition error in - confluent kafka topic create
 
[11/15/2022] Confluent CLI v2.32.1 Release Notes
- Bug Fixes
- Fix replication factor error in - confluent kafka topic create
- Print mirror topic name instead of source topic name in - confluent kafka mirror create
 
[11/3/2022] Confluent CLI v2.32.0 Release Notes
- New Features
- Improve error messages when users provide an incorrectly formatted Kafka cluster ID 
 
- Bug Fixes
- Fix CLI panic when setting environment in configuration 
 
[10/27/2022] Confluent CLI v2.31.0 Release Notes
- New Features
- Allow multiple connectors to be paused and resumed at once 
- Allow all flags accepting lists to accept comma-separated lists of strings 
- Add - --environmentflag to- confluent api-key list
- Verify that a cluster exists before unregistering it with - confluent cluster unregister
 
- Bug Fixes
- Only check for plugins in top-level directories within - $PATH
- Fix index out of range error in - confluent ksql cluster configure-acls
- Allow users with no role bindings to log in 
- Fix race condition during in-browser SSO login 
- Allow password prompt to be interrupted with Ctrl+C 
- Fix misleading error message in - confluent api-key store
 
[10/21/2022] Confluent CLI v2.30.1 Release Notes
- Bug Fixes
- Fix an app notarization issue affecting Darwin builds 
 
[10/21/2022] Confluent CLI v2.30.0 Release Notes
- New Features
- Add - confluent schema-registry schema list
 
- Bug Fixes
- Fix an issue preventing - confluent kafka cluster describefrom being called on a provisioning cluster
- Improve error messaging in - confluent kafka topicand- confluent kafka aclcommands
- Fix panic that could occur in some - confluent kafkacommands
 
[10/13/2022] Confluent CLI v2.29.0 Release Notes
- New Features
- Show more detailed error message in - confluent api-key use
 
[5/3/2023] Confluent CLI v2.28.2 Release Notes
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage 
 
[10/6/2022] Confluent CLI v2.28.1 Release Notes
- Bug Fixes
- Fix “unspecified resource type” error when describing or deleting Kafka ACLs 
 
[10/3/2022] Confluent CLI v2.28.0 Release Notes
- New Features
- General updates and improvements 
 
[9/29/2022] Confluent CLI v2.27.0 Release Notes
- New Features
- Confluent CLI is now available for Linux and Alpine Linux on ARM64 architecture 
- Added - Topic Countfield in- confluent kafka cluster describeand- confluent kafka cluster update
 
- Bug Fixes
- The - Errorfield in- confluent kafka link listwill now be empty instead of printing- NO_ERRORwhen the link is not in an error state
 
[9/22/2022] Confluent CLI v2.26.0 Release Notes
- New Features
- Display - State,- Errorand- Error Messagein- confluent kafka link list
- Show more detailed error messages for Confluent Cloud API routes 
 
[9/13/2022] Confluent CLI v2.25.0 Release Notes
- New Features
- Add - confluent environment describe
- Add - confluent api-key describe
- The - -vvvflag now notifies the user that- $PATHis recursively searched for plugins
 
- Bug Fixes
- Fix the example for - confluent kafka acl create
- Allow deletion of ksqlDB clusters that failed to provision 
 
Note
The new CLI plugins functionality, introduced in v2.24.0, searches your
entire $PATH and can cause slow response time.
If you are experiencing CLI commands hanging, set the following in the
~/.confluent/config.json file to disable the plugins:
"disable_plugins": true
[8/22/2022] Confluent CLI v2.24.2 Release Notes
- Bug Fixes
- Fix 404 error for - kafka aclcommands
- Fix non-root user in Docker image 
 
[8/21/2022] Confluent CLI v2.24.1 Release Notes
- Bug Fixes
- --unsafe-traceworks with every command that uses HTTP
- Fix panic that could occur when user was unauthenticated 
 
[8/18/2022] Confluent CLI v2.24.0 Release Notes
- New Features
- Added plugin framework and - confluent plugin listcommand
- Signed Windows binaries 
- Add non-root user to Dockerfile 
- Added examples for - confluent login
- Warn when updating read-only topic configurations in - confluent kafka topic update
 
- Bug Fixes
- Add global - --unsafe-traceflag
- Netrc auto-login should use the current context 
- Update command list on login in - confluent shell
- Prevent error when fetching Kafka cluster from within an API key context 
- Improve error messages in - confluent kafka topic create
 
[7/28/2022] Confluent CLI v2.23.0 Release Notes
- Bug Fixes
- Correctly identify Confluent Cloud contexts created with - confluent context create
- Fix panic when running - confluent local services connect startwithout “plugin.path”
 
[7/20/2022] Confluent CLI v2.22.0 Release Notes
- New Features
- Add - confluent iam user update
- Add - --packageflag to- confluent schema-registry cluster enable --package
- Add - confluent schema-registry cluster upgrade
- Improve error message when trying to delete a cluster with active connectors 
- Add “Detailed Processing Log” field to - confluent ksql cluster createand- confluent ksql cluster describe
- Add “Usage” field to - confluent service-quota list
 
- Bug Fixes
- Properly identify organizations on free trial 
- Fix panic when creating kSQL API keys with - confluent api-key createexceeds the quota
- Reformat error message when shrinking a cluster by more than 1 CKU in - confluent kafka cluster update
 
[7/11/2022] Confluent CLI v2.21.0 Release Notes
- New Features
- Add - confluent iam service-account describe
- Show more detailed error messages for Confluent Cloud API routes 
 
- Bug Fixes
- Fix issue where organizations are marked as suspended, even after being reactivated 
 
[6/30/2022] Confluent CLI v2.20.0 Release Notes
- New Features
- Support - --dry-runand- --no-validateflags for- confluent kafka link create
 
- Bug Fixes
- Refresh cached Kafka cluster metadata on a weekly basis, instead of infinitely 
 
[5/8/2023] Confluent CLI v2.19.1 Release Notes
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage 
 
[6/23/2022] Confluent CLI v2.19.0 Release Notes
- New Features
- Improve free remaining credit message in - confluent loginand- confluent cloud-signup
 
[6/16/2022] Confluent CLI v2.18.0 Release Notes
- New Features
- Show service account role bindings in - confluent iam role-binding list
- Improve examples for - confluent ksql cluster create
- Make errors more descriptive in - confluent api-key create
- Add “Service Provider Region” and “Package” fields to - confluent schema-registry cluster describe
- Add - --source-topicflag to- confluent kafka mirror topic create
 
- Bug Fixes
- Allow configuration values to contain commas in - --config
 
Confluent CLI v2.17.2 Release Notes
- Bug Fixes
- When running - confluent update, Alpine Linux users will update to a statically-linked CLI build, while other users will update to a dynamically-linked CLI build. See Prerequisites for details.
- On Alpine Linux, you cannot use - confluent updateto update from Confluent CLI versions earlier than v2.17.2. The- confluent updatecommand works for v2.17.2 or later. From the older versions, use- curlor tarball installation to update to the latest version. See Install Confluent CLI for details.
 
Confluent CLI v2.17.1 Release Notes
- New Features
- When running - confluent update, Alpine Linux users will update to a statically-linked CLI build, while other users will update to a dynamically-linked CLI build.
 
Confluent CLI v2.17.0 Release Notes
- New Features
- Allow suspended users to connect a credit card and redeem promo codes 
- Add - confluent schema-registry cluster delete
 
- Bug Fixes
- Improve error message when running - confluent kafka topic produce <topic> --value-formatwithout a schema path or schema ID specified
 
Confluent CLI v2.16.0 Release Notes
- New Features
- Retry 5 times if request fails in a subset of commands. 
- Add - --offsetflag to- confluent kafka topic consumecommand, allowing users to set an offset from the beginning to consume from
- Add - --partitionflag to- confluent kafka topic consumecommand, allowing users to consume from a certain partition of topic
 
- Bug Fixes
- Fix - environment not found in contexterror when passing audit log or connect event environment via- --environmentflag
- Remove the null byte prepended to messages when running - confluent kafka topic consumecommand without a schema
 
Confluent CLI v2.15.1 Release Notes
- Bug Fixes
- Resolve auth token refresh failure for a group of SSO users 
 
Confluent CLI v2.15.0 Release Notes
- New Features
- Add the ability to disable cloud features in the event of a security incident 
- Clarify that - confluent login --saveshould not be used with SSO login
 
Confluent CLI v2.14.0 Release Notes
- New Features
- Added - confluent schema-registry exportercommands for Confluent Platform
- Return a more specific error message if resource quota limits are exceeded 
 
- Bug Fixes
- Ignore redundant - --saveflag at- confluent loginfor SSO users
 
Confluent CLI v2.13.2 Release Notes
- Bug Fixes
- Fix panic on - confluent loginwhen user context is not defined
 
Confluent CLI v2.13.1 Release Notes
- Bug Fixes
- If user is already authenticated with a username and password, - confluent loginwill prompt for new credentials instead of refreshing the existing session
 
Confluent CLI v2.13.0 Release Notes
- New Features
- Automatically refresh sessions, keeping users logged in while the CLI is in use 
- Add - --principalflag to- confluent kafka aclcommands for filtering by service account or user
- Add - --config,- --config-file, and- --schema-idflags to- confluent kafka topic produceand- confluent kafka topic consume
- Improve documentation for - confluent kafka topic,- confluent ksql, and- confluent secret
 
- Bug Fixes
- Fix typos in various command descriptions 
 
Confluent CLI v2.12.0 Release Notes
- New Features
- Let - --kafka-cluster-idimply- --cloud-clusterin- confluent iam rbac role-binding list
- In - confluent schema-registry describeoptionally print the entire schema graph
 
- Bug Fixes
- Add dataplane roles to suggestion message in - iam rbac role describe
- Delete temporary schema directories after producing or consuming 
- Remove redundant log messages during API pagination 
 
Confluent CLI v2.11.0 Release Notes
- New Features
- Add - --full-headerflag to- confluent kafka topic consumeto print untruncated message headers
- Add support for source-initiated cluster links in Confluent Cloud 
 
- Bug Fixes
- Validate - --geoflag values when creating Schema Registry clusters
- Show all available roles with - confluent iam rbac role list
- Fix error message when resizing a Kafka cluster 
 
Confluent CLI v2.10.1 Release Notes
- Bug Fixes
- Add back - -Dshorthand for- --deletedflag in- schema-registry subject describe
 
Confluent CLI v2.10.0 Release Notes
- New Features
- New commands for Confluent Cloud: - schema-registry compatibilityand- schema-registry config
- New commands for Confluent Platform: - schema-registry compatibility,- schema-registry config,- schema-registry subject, and- schema-registry schema
 
- Bug Fixes
- Fix bug where locally stored API key could be cleared 
- Refresh SSO tokens on auto-login 
 
Confluent CLI v2.9.0 Release Notes
- New Features
- Migrated to new APIs that support faster cluster provisioning 
 
- Bug Fixes
- Fixed issue that prevented - HTTPS_PROXYenvironment variable from having an effect
- Fixed incorrect options for updating Schema Registry subject modes 
- Improved error messages and help examples 
 
Confluent CLI v2.8.1 Release Notes
- New Features
- Show user email, organization name, and organization ID on login 
 
- Bug Fixes
- Show the correct email when listing API keys for users with dataplane roles 
 
Confluent CLI v2.8.0 Release Notes
- New Features
- confluent service-quota listcommand for Confluent Cloud
- Add schema ID field in - confluent schema-registry schema describeoutput
 
- Bug Fixes
- Fix parsing of quoted flag values and arguments in - confluent shell
- Fix parsing of multi-value flags in - confluent shell
- Fix error with protobuf schema references for produce and consume commands 
 
Confluent CLI v2.7.0 Release Notes
- New Features
- Added - confluent kafka client-configcommands
- Improved logging for produce and consume commands, and during SSO login 
- Added support for multiline properties in cluster link configuration files 
 
- Bug Fixes
- Fixed capitalization in human-readable output 
 
Confluent CLI v2.6.2 Release Notes
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage 
 
Confluent CLI v2.6.1 Release Notes
- New Features
- Improved cipher algorithm used for - secretcommand
 
- Bug Fixes
- Fix issue with updating cluster links 
 
Confluent CLI v2.6.0 Release Notes
- New Features
- Verify checksums during - confluent update
- Enforce TLS 1.2 or greater 
- Added organization ID to login message 
- Produce and consume support for Confluent Platform 
- Add - kafka linkcommands for Confluent Platform
 
- Bug Fixes
- Allow colons in role binding subject resources 
- Improve error when logging in to a suspended org 
 
Confluent CLI v2.5.1 Release Notes
- Bug Fixes
- List ACLs created with service account resource IDs in - kafka acl list
- Improve suggestion when API key is not recognized as valid 
 
Confluent CLI v2.5.0 Release Notes
- Breaking Changes
- Due to backend changes, the - --dry-runand- --no-validateflags in the- kafka link createcommands no longer have an effect. Deprecation notices are added to the flag descriptions.
 
- New Features
- Improved shell completions for - bashand- zsh
- Add - ksql clustercommands and add deprecation warnings to- ksql appcommands
 
- Bug Fixes
- Fix potential panic in - kafka cluster describe
- Fix potential request failures for users with large number of resources 
- Improvements to error and help messages 
 
Confluent CLI v2.4.0 Release Notes
- New Features
- Add support for logging into specific Confluent Cloud organizations 
- Update - librdkafkato 1.8.2
- Don’t show deactivated users (or those with expired invitations) in role binding list command 
- Add on-prem replica management commands 
- Improved version of - confluent shellcommand
- Add autocompletion support for remaining command flags ( - --api-key,- --context,- --environment)
 
- Bug Fixes
- Fix issue where CLI would not show additional information with verbosity flags set ( - -v,- -vv,- -vvv,- -vvvv)
- Return error if SSO user enters different emails in CLI prompt and their SSO provider 
- Fix regression in - --ca-cert-pathflag so that it uses absolute filepaths
- Check whether service account exists before attempting to create or delete a Kafka ACL 
- Add friendlier error messages for RBAC commands 
 
Confluent CLI v2.3.1 Release Notes
- Bug Fixes
- Show the correct error for - confluent api-key listand- confluent audit-log describeif audit logs are disabled for an organization
 
Confluent CLI v2.3.0 Release Notes
- New Features
- Expand existing autocompletion functionality to include many command arguments and flags 
- Add built-in aliases for several long command names 
- Add reference support for JSON and protobuf in schema producer and consumer 
- Add - --subject-formatflag to- schema-registry exportercommands
- Notify user when ksqlDB cluster provisioning fails 
- Add extra validation logic for login URLs 
- Warn Confluent Platform users before enabling updates 
 
- Bug Fixes
- Create audit log API keys using the correct service account 
- Err if a process is already listening on the SSO callback port 
- Fix panic when autocompleting - service-accountcommands in- confluent shell
 
Confluent CLI v2.2.0 Release Notes
- New Features
- Properly label “PAUSED” ksqlDB clusters 
 
- Bug Fixes
- Fix Windows failures due to missing - pthreadslibrary
- NOTE: Users of - confluentv2.0.0, v2.1.0, or v2.1.1 must manually update to this version with- curl -sL https://cnfl.io/cli | sh -s -- -b $(dirname $(which confluent))
 
Confluent CLI v2.1.0 Release Notes
- New Features
- Restore partition count field when describing a topic’s configuration 
- Show success message when deleting a service account 
- Allow - CONFLUENT_PLATFORM_MDS_URLand- CONFLUENT_PLATFORM_CA_CERT_PATHto be used with- confluent cluster describe
 
- Bug Fixes
- Fix issue with listing pending user invitations 
- Fix issue with logging into SSO-enabled organizations when user is not already logged in 
- Only auto-login to the current context 
- Update description of - confluent prompt
- Hide - confluent iam aclcommands when logged into a cloud context
 
Confluent CLI v2.0.0 Release Notes
- Breaking Changes
- WARNING: If you are updating from a prior Confluent CLI v1.x client, note that this version is NOT interoperable with Confluent Platform v7.0 or earlier. See Supported Versions and Interoperability for full details on CLI client to Confluent Platform interoperability. 
- If you are updating from the Confluent Cloud CLI, the client name will change to - confluentwith this version.
- See Migration Guide for a full list of breaking changes and details regarding differences from v1.x. 
 
- New Features
- This version of Confluent CLI supports both Confluent Cloud and Confluent Platform management. - To use Confluent CLI v2.0 for Confluent Cloud, sign up with - confluent cloud-signupor authenticate with- confluent login.
 
Confluent CLI v1.43.2 Release Notes
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage 
 
Confluent CLI v1.43.1 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.43.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.42.0 Release Notes
- Bug Fixes
- Fix 404 error in - confluent kafka acl list
 
Confluent CLI v1.41.0 Release Notes
- New Features
- Add support for managing brokers and partitions 
 
Confluent CLI v1.40.2 Release Notes
- Bug Fixes
- Encrypt authenticated context and login credentials on local storage 
 
Confluent CLI v1.40.1 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.40.0 Release Notes
- Bug Fixes
- Fix issues when changing directories after logging in with a custom CA cert path 
- Make - confluent iam rolebinding listsupport filtering by resource
- Fix - confluent iam rolebinding listwhen no role is specified
 
Confluent CLI v1.39.1 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.39.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.38.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.37.1 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.37.0 Release Notes
- Bug Fixes
- Improved error messaging and help output 
 
Confluent CLI v1.36.0 Release Notes
- Bug Fixes
- Fix the issue of inserting - +for whitespace in- iam rolebindingparameters
 
Confluent CLI v1.35.0 Release Notes
- New Features
- Performance improvements 
 
- Bug Fixes
- Show all new release notes on CLI update 
 
Confluent CLI v1.34.0 Release Notes
- New Features
- Kafka ACL management via Confluent REST Proxy 
 
- Bug Fixes
- Fix logout panic when removing netrc entry 
 
Confluent CLI v1.33.0 Release Notes
- New Features
- Remove credentials from - .netrcfile when- logoutcommand is run
- Move non-interactive login/environment messages to debug-level printouts to - stderr
 
- Bug Fixes
- Fix supporting custom home directories specified via the - $HOMEenvironment variable
 
Confluent CLI v1.32.0 Release Notes
- Bug Fixes
- Fix - iam acl createbug for User principals with- @symbol
 
Confluent CLI v1.31.0 Release Notes
- New Features
- Increase default number of metadata key iterations from 1000 to 10000 
 
Confluent CLI v1.30.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.29.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.28.1 Release Notes
- Bug Fixes
- Fix bug where update command fails to find some versions 
 
Confluent CLI v1.28.0 Release Notes
- New Features
- Improved help text and examples 
 
Confluent CLI v1.27.0 Release Notes
- New Features
- Build and release darwin/arm64 binaries and archives 
 
Confluent CLI v1.26.0 Release Notes
- New Features
- Topic management commands via Confluent REST Proxy API 
 
- Bug Fixes
- Use - CONFLUENT_MDS_URLand- CONFLUENT_CA_CERT_PATHfor login command when set
- Require - --roleflag for- iam rolebinding deletecommand
 
Confluent CLI v1.25.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.24.0 Release Notes
- New Features
- Non-interactive login 
- CONFLUENT_MDS_URL and CONFLUENT_CA_CERT_PATH environment variable support 
 
Confluent CLI v1.23.0 Release Notes
- Bug Fixes
- Better handling of - --ca-cert-pathflag for saved logins
 
Confluent CLI v1.22.0 Release Notes
- New Features
- Stateless mode 
- Support self-signed certs for - confluent cluster describe
 
- Bug Fixes
- Fix - confluent local services startbug for Centos
- Fix no newline bug when auto injected configs are appended to manually added configs for - confluent localcommands
 
Confluent CLI v1.21.1 Release Notes
- New Features
- Fix case where wrong ca-cert-path might be used when logging in 
 
Confluent CLI v1.21.0 Release Notes
- New Features
- --promptflag for login command to bypass non-interactive login
 
- Bug Fixes
- Fix automatic update of auth tokens for username/email with special characters 
 
Confluent CLI v1.20.1 Release Notes
- New Features
- Prompt for credentials instead of throwing error when non-interactive login fails 
 
Confluent CLI v1.20.0 Release Notes
- New Features
- Verbose HTTP and TLS information is logged (with trace log level) when logging in to the CLI. 
- Non-interactive login supported via environment variables 
- Binaries and archives are now shipped for Alpine Linux 
 
- Bug Fixes
- Fixed issue where update command may not detect new CLI versions 
 
Confluent CLI v1.19.1 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.19.0 Release Notes
- New Features
- Infer default protocol and port number for URLs when logging in 
 
- Bug Fixes
- When using local Kafka sub-commands, only check status of Kafka cluster if it is a locally-running cluster 
- Fix flushing of logs and log processing during CLI startup 
 
Confluent CLI v1.18.0 Release Notes
- New Features
- Improve warning messages for audit log commands 
 
Confluent CLI v1.17.0 Release Notes
- New Features
- Expose context management commands 
 
- Bug Fixes
- Add additional logging when setting custom CA cert path 
- Updated list of connectors for CP 6.0 
- Fix KSQL path issue for CP verions older than 5.5 
- Minor documentation/example fixes 
 
Confluent CLI v1.16.0 Release Notes
- New Features
- Add audit log migration commands 
- Support piping credentials to login commands 
 
Confluent CLI v1.15.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.14.0 Release Notes
No changes relating to Confluent CLI for this version.
Confluent CLI v1.13.1 Release Notes
- Bug Fixes
- Fix command output bug for commands that were supposed to output to Stdout but were outputting to Stderr 
 
Confluent CLI v1.13.0 Release Notes
- New Features
- Allow for pipe-able log output from - confluent local services ... log.
 
- Bug Fixes
- Fix panic when invalid role is specified during resource-scoped rolebinding commands. 
- Fix grammar and typos in command help and examples. 
 
Confluent CLI v1.12.1 Release Notes
- Bug Fixes
- Fix success and error message display bug 
 
Confluent CLI v1.12.0 Release Notes
- Bug Fixes
- Improve error message handling for audit log commands 
- Fix parsing of credentials on Windows for login command 
 
Confluent CLI v1.11.0 Release Notes
- New Features
- Rewrite - confluent localcommand to use consistent grammar and eliminate need for passing – to subcommands with arguments
- Add - confluent clustercommand to register/unregister clusters from a Confluent Cluster Registry instance (Confluent Platform 5.5+)
- Update RBAC rolebinding commands to support friendly cluster names 
- Add Schema Registry ACLs commands for - confluent local
- Improve error and success messages and add suggestions for commands that don’t succeed 
 
- Bug Fixes
- Update macOS system requirements for Confluent Platform 6.0 
- Fix handling of errors from invalid RBAC rolebinding commands for Confluent Platform 6.0 
- Handle errors with loading CLI configuration files and ignore them when configs aren’t needed 
- Respect log output/verbosity levels when loading configuration files 
- Only check for updates once every 24 hours 
 
Confluent CLI v1.10.0 Release Notes
- Bug Fixes
- Compatibility fix for RBAC in Confluent Platform 5.x 
 
Confluent CLI v1.9.0 Release Notes
- Bug Fixes
- Restrict feedback nudges to fewer commands 
- Skip update check when running the update command 
 
Confluent CLI v1.8.0 Release Notes
- New Features
- Update RBAC rolebinding commands to support friendly cluster names (CP 6.0) 
- Add - feedbackcommand so users can give direct in-product feeback
- Start publishing release notes with each release 
 
- Bug Fixes
- Fix panics when metadata service returns internal server errors 
- Improve command examples in help output