{"record":{"id":"19a4c84eddf41e3e","repo":"langchain-ai/langgraph","slug":"invalid-namespace-label-label-found-in-namesp-19a4c8","errorCode":null,"errorMessage":"Invalid namespace label '{label}' found in {namespace}. Namespace labels cannot contain periods ('.').","messagePattern":"Invalid namespace label '(.+?)' found in (.+?)\\. Namespace labels cannot contain periods \\('\\.'\\)\\.","errorType":"validation","errorClass":"InvalidNamespaceError","httpStatus":null,"severity":"error","filePath":"libs/checkpoint/langgraph/checkpoint/store/base/__init__.py","lineNumber":1273,"sourceCode":"        if \".\" in label:\n            raise InvalidNamespaceError(\n                f\"Invalid namespace label '{label}' found in {namespace}. Namespace labels cannot contain periods ('.').\"\n            )\n        elif not label:\n            raise InvalidNamespaceError(\n                f\"Namespace labels cannot be empty strings. Got {label} in {namespace}\"\n            )\n    if namespace[0] == \"langgraph\":\n        raise InvalidNamespaceError(\n            f'Root label for namespace cannot be \"langgraph\". Got: {namespace}'\n        )","sourceCodeStart":null,"sourceCodeEnd":null,"githubUrl":"https://github.com/langchain-ai/langgraph/blob/38031739e551638e373fb553453256c23feeb41f/libs/checkpoint/langgraph/checkpoint/store/base/__init__.py#L1273","documentation":"Content check inside _validate_namespace: a label within the namespace contains a '.' character. Dots are the namespace separator in wire/storage representations (e.g. 'docs.user1'), so embedding one inside a label would make the path ambiguous and enable namespace-collision attacks; the offending label and full namespace are shown.","triggerScenarios":"Thrown at libs/checkpoint/langgraph/checkpoint/store/base/__init__.py:1273 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Replace '.' in labels with another delimiter such as '-' or '_' (e.g. 'v1.2' -> 'v1-2')","Split pre-joined namespaced strings into real tuples: ('docs', 'user1') instead of ('docs.user1',)","Sanitize external identifiers before using them as namespace labels"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"38031739e551638e373fb553453256c23feeb41f","analyzedAt":"2026-08-26T18:02:49.312Z","contentChangedAt":"2026-08-26T18:02:49.312Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}