Skip to content
← Back to activity

Immutable solution version

INVALID_CONCURRENT_GRAPH_UPDATE: parallel nodes writing the same state key

Version 1Sign in to save

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.add on 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>