3.2.6

What's Changed

Bug Fixes

Enhancements

Other Changes

3.3.0

What's Changed

Bug Fixes

• ccompat "/subjects/{subject}/versions/{version}" fails to resolve by integer sequence number when artifact uses semantic versioning (#7886)
• RetryInvocationHandler retries still not firing for HttpClosedException after #7847 (#7865)
• Stale Kafka topic cleanup policy in documentation (compact → delete) (#7830)
• CLI: Verbose mode does not affect Quarkus/JBoss logging (#7641)

Enhancements

• Operator: HPA support for app and UI deployments (#8079)
• [Data Contracts] Contract-to-Schema Artifact References (#7980)
• [Data Contracts] ODCS Artifact Type Registration (#7979)
• [Data Contracts] ODCS Export from Artifact (#7978)
• [Data Contracts] ODCS Contract REST API (#7977)
• [Data Contracts] ODCS Projection Engine (#7976)
• [Data Contracts] ODCS v3.1 Parser (#7975)
• Implement search capabilities in the CLI (#7786)
• Support working with version comments in the CLI (#7785)
• Operator should auto-create RBAC resources for KubernetesOps storage (#7720)
• feat(ui): Add support for Artifact References when registering artifacts/versions (#7704)
• Support context update in CLI (#7699)
• Support draft version content update in CLI (#7691)
• CLI: Implement automatic update with OS/architecture detection (#7642)
• [Data Contracts] Rule Execution Service (#7363)
• [Data Contracts] CEL Rule Executor (#7360)
• [Data Contracts] Rule Executor SPI (#7359)
• [Data Contracts] Tag Storage and Query (#7356)
• [Data Contracts] Protobuf Tag Extractor (#7355)
• [Data Contracts] JSON Schema Tag Extractor (#7354)
• [Data Contracts] Avro Tag Extractor (#7353)
• [Data Contracts] Tag Extraction SPI (#7352)
• [Data Contracts] Contract Rule REST API (#7350)
• [Data Contracts] Contract Rule Storage Implementation (#7349)
• [Data Contracts] Contract Rule Data Model (#7348)
• [Data Contracts] Promotion Workflow (#7242)
• [Data Contracts] Quality Score Calculator (#7241)
• [Data Contracts] GOVERNANCE Rule Type Implementation (#7239)
• [Data Contracts] Contract REST API Endpoints (#7238)
• [Data Contracts] Contract Metadata Model and Labels Convention (#7237)
• Support group rules management in the CLI (#7170)
• Support artifact rules management in the CLI (#7169)
• Support global rules management in the CLI (#7168)
• Support version management in the CLI (#7167)
• Support artifact management in the CLI (#7166)
• Support group management in the CLI (#7164)
• [Feature] API Lifecycle Governance (Deprecation, Consumer Tracking, Impact Analysis) (#7000)

Other Changes

• CLI: Add authentication support (Basic auth and OAuth2) (#8055)
• fix(app): remove extra quarkus-app wrapper directory from app zip/tar.gz package (#8039)
• CLI: Simplify ProblemDetails error handling pattern (#8031)
• CLI: Handle RuleViolationProblemDetails exception (#8026)
• CLI: Add context switching command (acr context use) (#8020)
• NullPointer exception when references are missing (JsonSchemaContentValidator) (#8014)
• CLI: exception when searching with label :foo (#8005)
• Avro schema references to pre-defined enum types not working as expected (#7970)
• Fix incompatibilities with Confluent Schema Registry identified by compatibility harness (#7962)
• Harden Protobuf upload validation against malformed identifiers and conflicting FQNs (#7909)
• Remove registryAvailableSince and studioAvailableSince from @Info annotation (#7839)
• CLI: Complete CDI conversion (Config singleton, Client static pattern) (#7640)
• [Feature] MCP Tool Definition Artifact Type (#7227)
• Create Apicurio Registry CLI MVP (#7127)
• Improve developer documentation about concepts and definitions (#367)

3.2.5

What's Changed

Bug Fixes

Enhancements

Other Changes

• UI test: masthead logo src is wrong and env var override is broken (#8042)
• [Docs] AI Agent Registry Documentation and Examples (#7231)

3.2.4

What's Changed

Bug Fixes

Enhancements

Other Changes

3.2.3

What's Changed

Bug Fixes

• Intermittent HttpClosedException in Vert.x client causes test failures (#7844)

Enhancements

• Support simultaneous proxy header authentication and OIDC authentication (#7812)

Other Changes

3.2.2

What's Changed

Bug Fixes

• Unit tests fail with Java heap space in apicurio-registry-app module (#7777)
• UI: Delete group option shown and spinner stuck when group deletion is disabled (#7701)
• Confluent compatibility API returns 500 when resolving schemas with semantic version references (#7694)
• resolveReferences() in AbstractSchemaResolver has duplicate recursive calls and bypasses schema cache (#7681)
• Configuration property apicurio.log.level is case-sensitive (#7680)
• Race condition in DocumentationTabContent and OpenApiVisualizer leaves empty visualization (#7632)
• sun.misc.Unsafe deprecation warning in Netty (#7399)
• Missing Netty macOS DNS resolver dependency (#7391)

Enhancements

• Support context update in CLI (#7699)
• Add support for AsyncAPI 3.1 (#7695)
• Add support for OpenAPI 3.2 (#7693)
• Support draft version content update in CLI (#7691)
• New artifact type: OpenRPC (#7598)
• sun.misc.Unsafe deprecation warning in Netty (#7399)
• Support group rules management in the CLI (#7170)
• Support artifact rules management in the CLI (#7169)
• Support global rules management in the CLI (#7168)
• Support version management in the CLI (#7167)

Other Changes

• KafkaSQL: DeleteAllExpiredDownloads scheduled job should not produce messages to the Kafka journal (#7796)
• KafkaSQL: new pod gets stuck during rolling update when other pods are running (#7795)
• Apicurio Registry system info API shows "In Memory" even when Postgres backend is enabled (#7791)
• KafkaSQL data not recovered after restart (registry appears empty) (#7753)
• Inline apicurio-ts-core into ui-editors to allow archiving the library (#7728)

3.2.1

What's Changed

Bug Fixes

• ElasticsearchSearchDecorator routes all searches through ES instead of only when required (#7593)
• QuickActions: "Create Artifact" button missing readOnly feature guard (#7592)
• Move PRIMARY KEY definitions inline in MySQL DDL to avoid Error 3750 (#7589)
• Search returns phantom result from internal metadata document (#7587)
• Bulk import via /admin/import fails with MySQL storage - "No value specified for parameter 3" (#7586)
• OIDC Re-authentication Recovery and Editor Draft Preservation (#7569)

Enhancements

• SerDes libraries do not propagate OpenTelemetry trace context to Registry (#7553)
• Support artifact management in the CLI (#7166)

Other Changes

• Split SDK HTTP adapters into separate modules for native image compatibility (#7614)
• Isolate JDK HTTP adapter references in RegistryClientRequestAdapterFactory for native image compatibility (#7613)

3.2.0

What's Changed

⚠️ Breaking Changes

• Health and metrics endpoints moved to management interface (port 9000): The Quarkus Management Interface is now enabled by default (#7483). Health (/health), metrics (/metrics), and readiness (/health/ready) endpoints are served on port 9000 instead of the main application port. If you rely on ServiceMonitor, liveness/readiness probes, or any monitoring integration pointing to the old port, you will need to update them. See the upgrade guide for details.

Bug Fixes

• Schema editor crashes on non-string example values (#7491)
• POST /search/versions misses versions promoted from DRAFT to ENABLED (search by content) (#7490)
• Version 3.1.x introduces undocumented breaking changes on schema resolution (#7471)
• Version references not saved if state is DRAFT (#7424)
• macOS CLI workflow fails due to missing Maven dependencies (#7415)
• Apicurio Java SDK - CVE-2026-1002 in Vertx-core (#7412)
• Schema caching not working with v3 API - API call made for every record (#7395)
• Apicurio Registry Startup Crash (Transient DNS Failure) (#7392)
• listArtifactVersions explicit sort is backwards (#7383)
• [AVRO] Registry does not support uploading schemas with record defined internally. (#7333)
• SerDes: Base64-encoded protobuf schemas fail to parse - missing decode step (#7269)
• Non-owners are able to update artifacts through the ccompact API (#7267)
• Protobuf schema compatibility check actual errors are not returned to clients (#7068)
• Silent exception swallowing in reference handling can mask errors (#6943)
• Registry basic authorization only supports one scope (Azure Entra-related) (#6348)
• Syntax Errors in Protobuf Schemas Are Not Detected During Registration (#6209)
• Trouble Using Confluent AvroConverter with apicurio registry (#4831)
• Cannot create custom artifact and schema resolvers from Quarkus based camel-kafka application (#4514)

Enhancements

• Remove JAXRSClientUtil and URL content fetching from v2 API (#7493)
• Enable Quarkus Management Interface for health and metrics endpoints (#7483)
• Add Strimzi Kafka Access Operator support to the Apicurio Registry Operator (#7475)
• Add JSON Schema visualization to the Web UI (MCP Server support) (#7466)
• Global configuration property to enable/disable experimental features (#7425)
• Add KubernetesOps Storage variant for managing artifacts via ConfigMaps (#7397)
• Add macOS GitHub Actions workflow for CLI tests (#7390)
• ccompat v7: Add normalize parameter to Compatibility endpoints (#7301)
• ccompat v7: Add missing Config Resource parameters and endpoint (#7300)
• ccompat v7: Add pagination and missing parameters to Subjects/Versions endpoints (#7299)
• ccompat v7: Add missing Schemas Resource endpoints and parameters (#7298)
• ccompat v7: Implement Exporter API endpoints (#7297)
• ccompat v7: Implement Mode API endpoints (#7296)
• Extended version command in the CLI (#7165)
• Add macOS support to Apicurio Registry CLI (#7163)
• Export just a single group (#5798)
• Report expected location of registry backend in UI (#5388)
• enhance : Search for the name of the property item in "Search for artifacts" API. (#1260)
• Update UI to support artifact properties (#948)
• Analyze protobuf package support (#427)

Other Changes

• Drop native Registry server support (#7489)
• NPE in ProtobufSchemaParser.parseSchema() when FileDescriptorUtils.toDescriptor() returns null (#7377)
• Simplify storage decorator chain architecture (#7313)
• Add recursion depth limit for reference resolution (#7312)
• Move orphan content cleanup to scheduled background job (#7311)
• Implement batch reference resolution to fix N+1 queries (#7310)
• Create BoundedCacheFactory utility (#7309)
• Merge CommonResourceOperations v2/v3 duplicates (#7307)
• Extract ParameterValidationUtils shared class (#7306)
• [Feature] JSON Schema Backing for LLM Artifact Types + MCP Format Alignment (#7254)
• Option to return stale cache entry immediately and refresh in background (#7248)
• JDK HTTP adapter fails when Vertx classes not on classpath - NoClassDefFoundError (#7223)
• Support secret files for docker compose (#7219)
• Upgrade PatternFly from v5 to v6 in UI (#7218)
• feat: Integrate A2A Agent Cards with LLM Artifact Types (#7215)
• [Feature] UI Support for LLM/AI Artifact Types (#7157)
• Strimzi >0.45.0 no longer supports Zookeper clusters (#6206)
• AvroSchemaParser::getSchemaFromData memory leak (#5968)
• protobuf-maven-plugin fails to compile (#5331)

3.1.7

What's Changed

Bug Fixes

• apicurio-registry with kafkasql missing auth in latest CRD (#7137)
• Protobuf compatibility check fails when reserving a range of field numbers (#7116)
• [UI] Too much horizontal space allotted to checkbox in "Versions in artifact" list (#7111)
• [Apicurio UI] Schema artifacts versions from other groups are shown in "default" aritfact versions view if the name is same (#7069)
• Deeplinking with Entra ID auth fails due to inability to configure wildcard RedirectURIs (#6364)
• [UI] Edit Owner action not working for Group (#4937)

Enhancements

• Allow to configure Jackson ObjectMapper 2 (#7194)
• Add proxy header authentication mechanism for reverse proxy deployments (#7139)
• POC: Externalized Authentication and Authorization via Reverse Proxy (#7133)
• [Feature] LLM/AI Model Schema Support (#6997)
• Add UI support for changing artifact/version state (#655)

Other Changes

• Refactor AbstractSqlRegistryStorage to use repository pattern (#7187)
• Add Debezium CDC with OpenTelemetry distributed tracing example (#7178)
• Otel implementation does not work since configuration properties are built time (#7147)
• Create OpenTelemetry distributed tracing example with Strimzi Kafka and Apicurio Registry (#7109)
• JDK HTTP Adapter: Authentication not implemented and other issues (#7071)
• Replace printStackTrace() calls with proper logging (#7070)
• [Task] Upgrade AsyncAPI parser to 3.0 support (Quick Win) (#7004)
• Environment variables inconsistent between documentation and examples (#5983)
• Create an example using TLS and credentials in a maven plugin (#4513)
• Request for clearer documentation over metrics support for Apicurio-registry (#879)

3.1.6

What's Changed

Bug Fixes

• Azure Entra ID authentication fails due to hardcoded loadUserInfo causing userinfo endpoint audience mismatch (#7051)

Enhancements

• Read schema from header instead of inferring it (#1484)

Other Changes

• docs: provide pointers to enable CORS (#707)