langchain-ai/langgraph · error · LangGraphBetaWarning

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

Error message

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

What it means

Error "The Encryption API is in beta and may change in future versions." thrown in langchain-ai/langgraph.

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)

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.