AISIX 0.3.1

Release date: July 9, 2026

This maintenance release adds SCIM directory sync and improves observability, accounting, on-premises playground access, and control-plane reliability.

New Features

• SCIM 2.0 directory sync can provision and deprovision organization members from any SCIM 2.0 identity provider, including Okta and Microsoft Entra ID, through the new /scim/v2 endpoints.

Improvements

• Gateway builds now report their release version in the Server response header, the output of aisix --version, and the data-plane version shown in the dashboard, rather than reporting a static build version.
• The per-client token metric now includes a cache-inclusive total series. See Metrics for the current metric catalog.
• Deployment cooldown metrics are emitted when health state changes.
• The guardrail management API is now included in the AISIX Cloud Admin API contract.

Fixes

• Every proxied response now includes an x-aisix-request-id header for correlation with logs and usage events.
• Anthropic prompt-cache tokens now count toward token rate limits on the native /v1/messages and /v1/responses endpoints.
• One malformed telemetry event no longer prevents the remaining events in the usage batch from being delivered.
• The on-premises dashboard playground can now reach private or internal LLM endpoints when AISIX_PLAYGROUND_ALLOW_PRIVATE_IPS is enabled.
• Sign-in now accepts the deployment's own origin and corresponding loopback origin, and returns clearer messages for rate-limited or untrusted-origin attempts.
• Member list pagination no longer returns to the first page shortly after the view loads.
• Control-plane restarts no longer produce harmless duplicate-constraint error logs.