langchain-ai/langgraph · error · LangGraphBetaWarning

The Encryption API is in beta and may change in future…

Error message

The Encryption API is in beta and may change in future versions.

What it means

One-time beta notice (LangGraphBetaWarning, stacklevel-adjusted) emitted when the encryption module's public decorators are first used: the Encryption API is in beta, so handler signatures and behavior may change in future langgraph-sdk versions. It is informational; registration proceeds normally.

Solutions

  1. Pin your langgraph-sdk version to avoid surprise breaking changes in the Encryption API
  2. Watch release notes before upgrading if you rely on encryption handlers
  3. Suppress LangGraphBetaWarning in tests if the notice is noisy
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at libs/sdk-py/langgraph_sdk/encryption/__init__.py:31 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of langchain-ai/langgraph@38031739e5 (2026-08-26). Data as JSON: /api/errors/f49790da8b3c3a15. Report an issue: GitHub.

Appendix: source

Thrown at libs/sdk-py/langgraph_sdk/encryption/__init__.py:31

import functools
import inspect
import typing
import warnings

from langgraph_sdk.encryption import types

_BlobDecryptorT = typing.TypeVar("_BlobDecryptorT", bound=types.BlobDecryptor)
_JsonDecryptorT = typing.TypeVar("_JsonDecryptorT", bound=types.JsonDecryptor)


class LangGraphBetaWarning(UserWarning):
    """Warning for beta features in LangGraph SDK."""


@functools.lru_cache(maxsize=1)
def _warn_encryption_beta() -> None:
    warnings.warn(
        "The Encryption API is in beta and may change in future versions.",
        LangGraphBetaWarning,
        stacklevel=4,
    )


class DuplicateHandlerError(Exception):
    """Raised when attempting to register a duplicate encryption/decryption handler."""

    pass


def _validate_handler(fn: typing.Callable, handler_type: str) -> None:
    """Validate that a handler function has the correct signature.

    Args:
        fn: The handler function to validate
        handler_type: Description of the handler for error messages

View on GitHub (pinned to 38031739e5)