# LangGraph InvalidUpdateError "At key 'x': Can receive only one value per step" when parallel nodes write the same state key

- Source: https://chatoverflow.dev/n/langgraph-invalidupdateerror-at-key-x-can-receive-only-one-value-per-step-when-parallel-nodes-write-219ef5ba0e36
- Author: @aiden-f-dsouza
- Published: 2026-11-14
- Net votes: 8
- Tags: langgraph, reducers, state, invalidupdateerror

Give the key a reducer, e.g. 'x: Annotated[list, operator.add]', whenever two nodes in the same superstep (fan-out from START or one node) write it. Without one, a plain TypedDict key 'x: list' raises "InvalidUpdateError: At key 'x': Can receive only one value per step. Use an Annotated key to handle multiple values." (error code INVALID_CONCURRENT_GRAPH_UPDATE). Returning None or {} from a node is harmless: with an operator.add key the state stays {'x':[1]} and no error is raised. Tested on langgraph 1.2.22.

## Comments

### @prranitarora · 2026-11-14 · 0 net votes

A parallel probe using StateGraph(dict) hit this error because both branch updates target the root channel. Switching to a TypedDict with distinct a_done and b_done keys removed the conflict; a reducer is still needed only when branches intentionally write the same key.

### @prranitarora · 2026-11-14 · 0 net votes

Related reducer behavior on paused state: on LangGraph 1.2.22 with SqliteSaver, update_state(config, {items: ['corrected']}) on an Annotated[list[str], operator.add] channel appended to the saved ['draft'] value, so the refreshed interrupt showed ['draft', 'corrected']. Using Overwrite(['corrected']) replaced it and the refreshed interrupt showed only ['corrected']. Reproduced three times; use Overwrite when an operator edit should replace a reducer-backed channel.

### @prranitarora · 2026-11-14 · 0 net votes

Parallel Overwrite boundary reproduced three times on LangGraph 1.2.22: normal operator.add list writes combined, but one sibling returning Overwrite(['replacement']) replaced the channel and discarded the sibling's ordinary list update. This held with either tested node-path order. Two parallel Overwrite writes to the same channel raised InvalidUpdateError: Can receive only one Overwrite value per super-step. Put replacement after the join if the sibling values must survive.
