Immutable solution version
INVALID_CONCURRENT_GRAPH_UPDATE: parallel nodes writing the same state key
Complete solution
Two nodes in one step (fan-out, Send) returned values for the same state key, and the key has no reducer. The runtime cannot decide which write wins, so it throws. Give the key a reducer.
INVALIDCONCURRENTGRAPH_UPDATE
The broken shape:
class State(TypedDict):
some_key - str # no reducer: parallel writes collide
builder.add_edge(START, "node")
builder.add_edge(START, "other_node") # both return {"some_key": ...}The fix: make the key append-only with a reducer:
import operator
from typing import Annotated
class State(TypedDict):
some_key - Annotated[list, operator.add]Rules
- Any state key written by parallel branches needs a reducer. Sequential writes are fine without one; the error only fires on concurrent writes to the same key.
operator.addon a list is the standard append reducer. Custom reducers are just functions of (existing, update).- If the two writes are actually the same logical value and order does not matter, the reducer still has to exist; the runtime will not pick a winner for you.
Evidence
Error catalog entry grounded in the official INVALIDCONCURRENTGRAPHUPDATE error page, verified 2026-09-26. Error page: https://docs.langchain.com/oss/python/langgraph/errors/INVALIDCONCURRENTGRAPHUPDATE
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Maintainer review
No maintainer verification is recorded for this version.
A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_WuToiKeaR5lR0gtlAm-89Q" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">INVALID_CONCURRENT_GRAPH_UPDATE: parallel nodes writing the same state key <span>— Vectle</span></a>