API7 Enterprise Release Notes
3.9.3
Release Date: 2026-01-26
Features
Plugins
- AI Request Rewrite
- Supported two new providers: Gemini, Vertex AI.
- SAML Auth
- Added
auth_protocol_binding_methodparameter to support configuring SAML protocol binding methods, includingHTTP-POSTandHTTP-Redirect. The default value isHTTP-Redirect(backward compatible with previous versions).HTTP-POSTmust be used when Azure AD is the identity provider.
- Added
Fixes
Plugins
- SAML Auth
-
Fixed issue: SAML sessions could not be shared across multiple gateway instances. Added the mandatory
secretfield for configuring the key to encrypt session data.Upgrade noteThe
saml-authplugin upgraded from older versions can work normally but cannot share sessions across multiple gateway instances. This issue can be resolved by configuring thesecretfield. -
Fixed issue: Missing
NameIDfield in the SAML request when processing logout requests. The absence of theNameIDfield will cause logout failure when Azure AD is the identity provider.
-
3.9.2
Release Date: 2026-01-19
Features
Plugins
- AI Proxy/AI Proxy Multi
- Supported four new providers: Gemini, Vertex AI, OpenRouter, and Anthropic.
- Basic Auth/JWT Auth/Key Auth/HMAC Auth/LDAP Auth
- Added a
realmconfiguration option to set the Realm value in theWWW-Authenticateresponse header for 401 authentication failures.
- Added a
- OpenID Connect
- Supported validating claims by configuring
claim_schema.
- Supported validating claims by configuring
Control Plane
- Rejected gateway nodes with a version higher than the Control Plane.
- Supported querying node health status in multi-upstream scenarios.
Fixes
Plugins
- Limit Count
- Fixed issue: The rate limiting counter was shared when the same rate-limiting configuration was applied across multiple consumers (introduced in 3.8.5).
- Limit Count Advanced
- Fixed issue: Incorrect data appeared when resetting request headers (introduced in 3.8.19).
- Fixed issue: Rate limiting data was not correctly submitted after enabling Redis delayed synchronization (introduced in 3.8.19).
- Fixed issue: Redis password could not be specified in Redis Sentinel mode.
- Fixed issue: Keepalive was not enabled for Redis connections in Redis Sentinel mode.
- Syslog
- Fixed issue: After sending an excessively long log in UDP mode, subsequent logs could not be sent.
- Request ID
- Fixed issue: The system failed to generate a new request ID when the
request-idprovided by the client was empty.
- Fixed issue: The system failed to generate a new request ID when the
Data Plane
- Fixed issue: A
deepcopy table overflowerror could occur during the startup process. - Fixed issue: The
serverheader still returned "APISIX" whenenable_server_tokenswas disabled. - Fixed issue: The health checker caused the gateway to continuously output error logs after an update to the
ai-proxy-multiplugin.
Control Plane
- Fixed issue: The default
client.depthfor SSL resources was too small, causing mTLS migration failure for Cloud v2 users. - Fixed issue: Data duplication could occur during concurrent calls to the SSL API.
- Fixed issue: The health status of frontend components on the Dashboard was not reflected in the
/healthzAPI response.
3.9.1
Release Date: 2026-01-08
Fix
Developer Portal
- Fixed issue: "Developers" created in older versions of the Developer Portal could not be deleted.
3.9.0
Release Date: 2026-01-06
Features
- All API7 Enterprise Docker images are now signed using Cosign, enhancing image security.
Developer Portal
- Newly Redesigned Developer Portal
- Provides open-source SDKs and a frontend scaffolding project to facilitate user customization and development.
- Introduces a new Portal-level authentication mechanism for API integration.
- Removes the built-in Portal SSO feature.
Plugins
-
-
Supported using Redis and Redis Cluster as the rate limiting data storage backend.
Upgrade noteAdded a new required field
policy. Existing configurations do not require modification and will continue to function in the data plane. However, when updating a configuration, this field must be supplied (e.g.,policy=local), otherwise the update will be rejected.
-
-
- Added a new algorithm
ksuidfor ID generation.
- Added a new algorithm
-
- Supported customizing HTTP headers sent to the Loki server.
-
File Logger
- Supported conditional request logging using the
matchfield.
- Supported conditional request logging using the
-
- The
rulesfield is now required.
- The
Control Plane
- Allowed to completely disable built-in username/password login after enabling SSO login.
- Supported configuring the maximum execution time for database statements.
- Observability Enhancements
- Enabled the pprof performance profiling by default.
- Added database connection pool metrics to the metrics endpoint.
- Supported separate logging for access and error logs.
- Added the
request_idfield to access and error logs.
Fixes
Plugins
- OpenAPI to MCP
- Fixed issue: Passing authentication credentials via query parameters could lead to sensitive information leakage.
Data Plane
- Optimized caching behavior for resolution chains that involve CNAME and A records.
Control Plane
- Removed the display of IP and Port from the gateway instance list to avoid misleading users.
- Fixed issue: Database deadlocks could occur during concurrent batch inserts into the API call statistics table.
- Fixed issue: Dashboard failed to start when using a non-
publicschema in PostgreSQL.
3.8.22
Release Date: 2026-01-19
Fixes
Plugins
- Limit Count
- Fixed issue: The rate limiting counter was shared when the same rate-limiting configuration was applied across multiple consumers (introduced in 3.8.5).
- Limit Count Advanced
- Fixed issue: Incorrect data appeared when resetting request headers (introduced in 3.8.19).
- Fixed issue: Rate limiting data was not correctly submitted after enabling Redis delayed synchronization (introduced in 3.8.19).
- Fixed issue: Redis password could not be specified in Redis Sentinel mode.
- Fixed issue: Keepalive was not enabled for Redis connections in Redis Sentinel mode.
- Syslog
- Fixed issue: After sending an excessively long log in UDP mode, subsequent logs could not be sent.
- Request ID
- Fixed issue: The system failed to generate a new request ID when the
request-idprovided by the client was empty.
- Fixed issue: The system failed to generate a new request ID when the
Data Plane
- Fixed issue: A
deepcopy table overflowerror could occur during the startup process.
Control Plane
- Fixed issue: The default
client.depthfor SSL resources was too small, causing mTLS migration failure for Cloud v2 users. - Fixed issue: Data duplication could occur during concurrent calls to the SSL API.
3.8.21
Release Date: 2025-12-23
Features
Plugins
- gRPC Web
- Supported enabling the plugin on routes that use non-wildcard paths.
- OpenAPI to MCP
- Provided the
flatten_parametersparameter to control whether path and query parameters from the OpenAPI specification are placed at the top level of the tools input schema.
- Provided the
Data Plane
- Fallback CP
- Supported using the gateway as a backup node to sync data to AWS S3 and Azure Blob. Note that backup nodes do not provide HTTP/HTTPS services and are not counted towards the license quota.
- Supported authentication using AWS IAM Role and Azure Managed Identity.
Control Plane
- Supported using MSSQL Server 2022 as the database for the control plane.
- Provided script generation for deploying gateway instances using Docker Compose.
- Improved the text prompts for each parameter when deploying gateway instances in Kubernetes.
Fixes
Plugins
- AI Proxy/AI Proxy Multi
- Fixed issue: Headers configured in the plugin could not override downstream headers with the same name due to case-insensitivity.
- Limit Conn/Limit Count Advanced/AI Rate Limiting
- Fixed issue: The
rules.keyfield did not support the variable default value syntax.
- Fixed issue: The
- OpenAPI to MCP
- Fixed issue: Errors or perpetual loading occurred when configuring the MCP Server in AI clients such as Cursor and Cline.
Data Plane
- Fixed issue: The gateway continued its startup process even after failing to connect to the control plane during initialization.
- Fixed issue: Heartbeat failed when the gateway listened on the same port using different IP addresses.
- Fixed issue: The Fallback CP feature failed to load credential data correctly.
- Fixed issue: Optimized the performance after enabling the Prometheus plugin.
Control Plane
- Fixed issue: For services created via the Admin API, their routes could not be selected on the console's monitoring page to view monitoring data.
- Fixed issue: Incorrect "Unhealthy Ratio" data displayed on the console's upstream page after configuring active health checks for an upstream.
3.8.20
Release Date: 2025-12-11
Fixes
- OpenAPI to MCP
- Fixed issue: Variables in
base_urlwere not resolved correctly.
- Fixed issue: Variables in
3.8.19
Release Date: 2025-12-09
Features
Plugins
- OpenAPI to MCP
- Supported using variable syntax in
base_url.
- Supported using variable syntax in
- AI Rate Limiting
- Supported using Redis, Redis Cluster, and Redis Sentinel as storage backends.
The ai-rate-limiting plugin now requires a new policy field. Existing configurations continue to function on the data plane, but any updates must include policy: local; otherwise, the update will be rejected.
Data Plane
- Added support for the
${external_user.*}built-in variable to retrieve values from external user information. The variable is injected by theopenid-connectplugin and developer portal OAuth authentication.
Fixes
Plugins
- AI Proxy/AI Proxy Multi
- Fixed issue: Request headers generated by the client or other plugins were not forwarded to the upstream.
- AI Rate Limiting/Limit Count Advanced
- Fixed issue: When multiple
ruleswere matched simultaneously, the rate-limiting headers could not be distinguished. By default, they are now distinguished by the index of the matchedrule. Theheader_prefixconfiguration is also supported for custom prefixes. - Fixed issue: When variables were used in the
limitfield, the rate-limiting status was not updated in real-time after the variable's value changed.
- Fixed issue: When multiple
Control Plane
- Fixed issue: Users' access tokens could still be used to access APIs after expiration.
- Fixed issue: The "Labels" section in the Dashboard displayed a large number of duplicate input fields when creating a route.
- Fixed issue: Disabled plugins on a route could not override enabled plugins of the same name on the associated service.
- Fixed issue: Dropdown option values in the Portal Dashboard changed frequently.
- Fixed issue: Plugin configurations in the Dashboard did not automatically populate default values.
3.8.18
Release Date: 2025-11-25
To support creating multiple Portal instances, the portal-auth plugin of the data plane has been upgraded. After upgrading the control plane, users should upgrade the data plane as soon as possible. During the period between the control plane upgrade and the data plane upgrade completion, please do not update existing API products, as such changes will not take effect.
Features
Data Plane
- Supported specifying the
backlogconfiguration for listening ports. - Supported Azure Blob storage type in
fallback_cp.
Control Plane
- Supported Dynamic Client Registration (DCR) provider management.
- Supported DCR authentication type in API products.
- Supported OAuth authentication type (obtaining client ID and client secret based on DCR) in Developer credentials.
- Supported creating multiple Portal instances. Existing Portal usage data will be assigned to the automatically created
defaultPortal instance. - API7 Dashboard supported specifying the license storage path in the configuration file.
Fixes
Plugins
- All Logger Plugins
- Fixed issue: Logger plugins failed to obtain request bodies when client request bodies were too large to generate temporary files.
- AI Proxy Multi
- Fixed issue: Health checkers were rebuilt when requests hit different consumers.
Control Plane
- Fixed issue: The Helm Chart version was not locked in the Ingress Controller installation script.
- Fixed issue: Offline gateway instances were still displaying compatibility tags.
- Fixed issue: When creating/updating upstreams, the system did not check if
upstream_hostwas empty whenpass_hostwas set torewrite. - Fixed issue: In the Developer Portal, when OpenAPI documents contained multiple
server_urls, developers could not select aserver_urlwhen initiating test requests. - Fixed issue: Developers with subscriptions under the "pending approval" state can still make requests to the gateway.
3.8.17
Release Date: 2025-11-10
Features
Plugins
- Limit Conn
- Supported variable syntax in the
connandburstfields. - Added a
rulesfield for configuring multiple rate-limiting rules simultaneously.
- Supported variable syntax in the
- Limit Count Advanced
- Supported variable syntax in the
countandtime_windowfields. - Added a
rulesfield for configuring multiple rate-limiting rules simultaneously.
- Supported variable syntax in the
- AI Rate Limiting
- Supported variable syntax in the
limitandtime_windowfields. - Added a
rulesfield for configuring multiple rate-limiting rules simultaneously.
- Supported variable syntax in the
- OpenAPI to MCP
- Considered the default values of query parameters defined in OpenAPI when sending requests to the upstream service.
- All Logger Plugins
- Supported configuring the maximum number of pending entries in the batch processor.
- Flushed the pending logs to the logging service before the worker process exited.
Control Plane
- Supported configuring IP whitelist and blacklist for accessing the dashboard.
Fixes
Data Plane
- AI Proxy Multi
- Fixed issue: Multiple worker processes cannot share the health checker of an AI instance.
- AI Request Rewrite
- Fixed issue: The
aimlapiprovider is not working.
- Fixed issue: The
Control Plane
- Fixed issue: Cannot upload license when the browser lacks permissions.
- Fixed issue: Bad performance of the gateway when the number of
upstream.nodesis very large. - Fixed issue: The
policyfield of plugins, such aslimit-countandlimit-count-advanced, is optional (should be required). - Fixed issue: When creating a new SSO page and clicking "Back", the page redirected to the SMTP Server page.
3.8.16
Release Date: 2025-10-28
Features
Plugins
- Kafka Logger
- Supported SCRAM-SHA-512 in SASL mechanism.
Control Plane
- Added support for specifying host when publishing Gateway service in API Portal.
- Added cache configuration support for query failure scenarios in the Gateway secret module.
- Updated Ingress Controller installation form to support configuring namespace and name.
- Specified supported versions when importing OpenAPI in the Dashboard UI.
- Removed the bare metal tab from the Gateway deployment page.
Fixes
Data Plane
- OpenAPI to MCP
- Fixed issue: SSE mode does not work when
path_prefixandstrip_path_prefixwere both configured in the service. - Fixed issue: MCP tool names were generated from the OpenAPI paths, which could exceed the length limit for tool names. Now MCP tool names are generated from OpenAPI operation IDs.
- Fixed issue: A 500 status code was thrown when the headers field was not configured.
- Fixed issue: SSE mode does not work when
Control Plane
- Fixed issue: ADC Sync could synchronize to the wrong gateway group when group names were similar.
- Fixed issue: Login option role mapping retained previous roles even when no rules were matched.
- Fixed issue: The Request Scope field of the OIDC Login Option included an unnecessary “Add” button.
- Fixed issue: Old configurations were sometimes not displayed in the Edit Login Option form.
- Fixed issue: Unnecessary changes occurred during ADC diff due to overly complex core resource schema.
- Fixed issue: User’s
updated_attimestamp was not refreshed when updating user roles.
3.8.15
Release Date: 2025-10-13
Features
Plugins
- Lago
- Introduced new plugin.
- Traffic Split
- Now available for Stream service.
- OpenAPI to MCP
- Supported streamable HTTP as a transport method for MCP.
Control Plane
- Supported configuring the Prometheus query path prefix in Dashboard.
Fixes
Data Plane
- Fixed issue: Creating multiple GatewayProxy/IngressClass for the same gateway group will cause resource conflicts and route overwrites.
- Fixed issue: Error logs contain sensitive information.
- Fixed issue:
grpc-webresponses lost trailers when the response body was empty.
3.8.14
Release Date: 2025-09-25
Fixes
Data Plane
- Fixed issue: Upstream reference error when configuring multiple services with duplicate backends in Ingress Controller v2.0.6.
- Fixed issue: Gateway instance status calculation error when using PostgreSQL databases with non-UTC timezones.
3.8.13
Release Date: 2025-09-23
Features
Plugins
- OpenAPI to MCP
- Introduced new plugin.
Dashboard
- Supported Admin API and DPM Address in API7 Helm Chart.
Data Plane
- Supported configuring the Prometheus remote write endpoint URLs in DP Manager.
- Aligned the certificate usage API response fields with the OpenAPI specification.
Fixes
Dashboard
- Fixed issue: Prompt message handling for internal login email integration on the API7 Dashboard.
- Fixed issue: Error messages for invalid custom plugin schemas, previously only visible in the browser console, are now displayed on the API7 Dashboard.
- Fixed issue: Configuration interference between
include_resp_bodysettings across logging plugins. - Fixed issue: Warnings appeared during the frontend console build process.
Data Plane
- Fixed issue: Secrets could not be dynamically updated.
Developer Portal
- Fixed issue: OAS could not be queried when creating products in Provider Portal for services created using ADC.
- Fixed issue: Hierarchy issues when downloading OpenAPI documentation in Provider Portal.
3.8.12
Release Date: 2025-09-17
Fixes
Dashboard
- Fixed issue: Users with policies scoped by
service_labelcould not edit the corresponding services or service templates. - Fixed issue: Authorization by label on service templates incorrectly reused the label of a published service with the same ID during list API authorization.
3.8.11
Release Date: 2025-08-25
Features
Plugins
- AI Request Rewrite
- Introduced new plugin.
- AI RAG
- Introduced new plugin.
- AI AWS Content Moderation
- Introduced new plugin.
Dashboard
- Improved guidance when the root user generates a token. The UI now clearly instructs users to create a new user and generate tokens under that account.
- Supported enabling pprof in the Enterprise control plane with a configuration switch. It listens on 127.0.0.1 and is disabled by default.
Dependencies
- Included the latest version of ADC in the Enterprise offline release package.
Fixes
Data Plane
- Fixed issue: With the EWMA load balancing algorithm, historical statistics were not cleaned up, which could exhaust the allocated shared memory and cause errors.
Plugins
- Custom Plugins
- Fixed issue: Uploading a custom plugin without a
schemareturned 500.
- Fixed issue: Uploading a custom plugin without a
- Basic Auth
- Fixed issue: Made the scheme part ("Basic") case-insensitive.
- AI Proxy Multi
- Fixed issue: Abnormal traffic distribution.
- AI Prompt Decorator
- Fixed issue: User historical messages were incorrectly appended to
messagesin logs/configurations. The plugin now only inserts system prompts as expected.
- Fixed issue: User historical messages were incorrectly appended to
Dashboard
- Fixed issue: Users logging in on multiple devices could get stuck on the license activation page.
- Fixed issue: The
/pluginskey was only written during custom plugin operations or at dashboard startup. As a result, creating a new gateway under a newly created gateway group could not synchronize the list of enabled plugins from the control plane. The key is now created correctly. - Fixed issue: When creating Services via ADC, duplicate Routes across different Services were not detected by the route conflict checker.
- Fixed issue: Long labels were not fully displayed in the UI.
- Fixed issue: Concurrently creating a Service with the same ID could result in duplicate creation.
- Fixed issue: Creating two Routes simultaneously could report that the Routes' Service already exists.
- Fixed issue: On the login page, when there were too many login options, the header overlapped and the page could not scroll.
3.8.10
Release Date: 2025-08-25
Features
Data Plane
- Supported configuring the addresses for DP Manager and the Admin API via an API7 Dashboard configuration file.
Dashboard
- Supported specifying the Admin API address in the gateway deployment configuration, which will be used to populate the GatewayProxy Endpoint address in the API7 Ingress Controller deployment script.
- Consolidated
allow_accessAPI calls in the API7 Dashboard frontend to reduce redundant requests. - Added
hash_onconfiguration item to upstream connection configuration.
Fixes
Data Plane
- Fixed issue: A deadlock could occur when the Control Plane updates the service API due to insufficient database connections.
- Fixed issue: Upon restarting, worker processes could load stale data from the master process. This could cause temporary request failures (e.g., 404 errors) for recently created or modified routes before the worker process synchronized the latest data from etcd.
- Fixed issue: Etcd history compaction could trigger a full data load in APISIX, causing a significant performance impact on the etcd service, especially in environments with a large number of gateway nodes.
Plugins
- AI Proxy Multi
- Fixed issue: A panic was triggered by connection timeouts to the upstream service.
- Removed the
ext-plugin-pre-req,ext-plugin-post-req, andext-plugin-post-respplugins from the Enterprise Edition.
Dashboard
- Fixed issue: A consumer could not be created when its permission policy was configured to grant all permissions based on labels.
- Fixed issue: In the consumer list page, pagination would occasionally fail. Attempting to navigate to another page would result in a brief loading state, but the view would remain on the current page.
3.8.9
Release Date: 2025-08-11
Features
Data Plane
- Supported Kubernetes 1.18 in API7 Enterprise Ingress Controller.
- Backported Chaitin WAF plugin from APISIX to API7 Enterprise.
Plugins
- JWT Auth
- Added
store_in_ctxparameter to store validated JWT object in request context. When set to true (default is false), the plugin stores the validated JWT object in the request context, useful for custom plugins that need to parse JWT to extract permissions.
- Added
- Workflow
- Added support for
limit-connplugin integration, allowing dynamic connection limit strategies based on user requests and current APISIX load pressure.
- Added support for
Dashboard
- Added audit log record TTL configuration option, allowing users to set automatic deletion time for audit log table data. Default value is 60 days.
- Optimized Dataplane manager SQL statements when updating cached Consumer data.