●Change8

Migrating to Hasura Auth v2.45.4

Version v2.45.4 introduces 2 breaking changes. This guide details how to update your code.

Released: 5/14/2026

2
Breaking Changes
4
Migration Steps
12
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

hasura_http_response_bytes_totalremoveLiveQueryremoveStreamingQueryHASURA_GRAPHQL_CACHING_REDIS_POOL_SIZEHASURA_GRAPHQL_RATE_LIMIT_REDIS_POOL_SIZEHASURA_BIGQUERY_SLOW_INTROSPECTION_FALLBACKconnection_lifetimehasura_metadata_inconsistenciesAGGREGATE_FUNCTIONJAVA_OPTSnet.snowflake.jdbc.enableBouncyCastleremove_empty_subscription_responses

Breaking Changes

●Issue #1

When remote schema types conflicted with action types, the conflict was previously silently ignored; now it results in metadata inconsistency errors (`inconsistent_metadata`). Deployments relying on this silent exclusion must now resolve the type conflicts.

●Issue #2

The event trigger log format has changed.

Migration Steps

  1. 1
    If you previously relied on remote schema type conflicts being silently ignored, you must now resolve these conflicts to remove metadata inconsistency errors.
  2. 2
    Users configuring RTS should review GHC 9.14.1 runtime system behavior, especially if using `--nonmoving-gc` and previously setting the `-F` or `-Fd` flags, and may wish to tune them based on new GHC documentation.
  3. 3
    Set `JAVA_OPTS=-Dnet.snowflake.jdbc.enableBouncyCastle=true` in the environment if using RSA key authentication with the bundled super-connector. _(Enterprise edition only)_
  4. 4
    If BigQuery schema introspection exhibits unexpected bugs after upgrading, set `HASURA_BIGQUERY_SLOW_INTROSPECTION_FALLBACK=true` in the environment to revert to the previous introspection method.

Release Summary

This patch release (v2.45) introduces several bug fixes across server components, data connectors, and the Console, alongside minor performance improvements and configuration options for Redis pooling. Notably, it now errors on previously silent remote schema/action type conflicts.

Need More Details?

View the full release notes and all changes for Hasura Auth v2.45.4.

View Full Changelog