{"record":{"id":"a4df56b5726ac307","repo":"langchain-ai/langgraph","slug":"checkpointer-true-cannot-be-used-for-root-graphs","errorCode":null,"errorMessage":"checkpointer=True cannot be used for root graphs.","messagePattern":"checkpointer=True cannot be used for root graphs\\.","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"libs/langgraph/langgraph/pregel/main.py","lineNumber":2584,"sourceCode":"            output_keys = self.stream_channels_asis\n        else:\n            validate_keys(output_keys, self.channels)\n        interrupt_before = interrupt_before or self.interrupt_before_nodes\n        interrupt_after = interrupt_after or self.interrupt_after_nodes\n        if isinstance(stream_mode, str):\n            stream_modes = {stream_mode}\n        else:\n            stream_modes = set(stream_mode)\n        if isinstance(print_mode, str):\n            stream_modes.add(print_mode)\n        else:\n            stream_modes.update(print_mode)\n        if self.checkpointer is False:\n            checkpointer: BaseCheckpointSaver | None = None\n        elif CONFIG_KEY_CHECKPOINTER in config.get(CONF, {}):\n            checkpointer = config[CONF][CONFIG_KEY_CHECKPOINTER]\n        elif self.checkpointer is True:\n            raise RuntimeError(\"checkpointer=True cannot be used for root graphs.\")\n        else:\n            checkpointer = self.checkpointer\n        if isinstance(checkpointer, BaseCheckpointSaver):\n            checkpointer = self._apply_checkpointer_allowlist(checkpointer)\n        if checkpointer and not config.get(CONF):\n            raise ValueError(\n                \"Checkpointer requires one or more of the following 'configurable' \"\n                \"keys: thread_id, checkpoint_ns, checkpoint_id\"\n            )\n        if CONFIG_KEY_RUNTIME in config.get(CONF, {}):\n            store: BaseStore | None = config[CONF][CONFIG_KEY_RUNTIME].store\n        else:\n            store = self.store\n        if CONFIG_KEY_CACHE in config.get(CONF, {}):\n            cache: BaseCache | None = config[CONF][CONFIG_KEY_CACHE]\n        else:\n            cache = self.cache\n        if durability is None:","sourceCodeStart":2566,"sourceCodeEnd":2602,"githubUrl":"https://github.com/langchain-ai/langgraph/blob/38031739e551638e373fb553453256c23feeb41f/libs/langgraph/langgraph/pregel/main.py#L2566-L2602","documentation":"Error \"checkpointer=True cannot be used for root graphs.\" thrown in langchain-ai/langgraph.","triggerScenarios":"Thrown at libs/langgraph/langgraph/pregel/main.py:2584 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"38031739e551638e373fb553453256c23feeb41f","analyzedAt":"2026-08-26T18:02:49.312Z","schemaVersion":2},"datasetVersion":"2026-08-26T21:11:00.512Z"}