---
outline: deep
---

# DF8201: Terminal Session Not Registered

## Message

> Terminal session with id "`{id}`" not registered

## Cause

`ctx.terminals.update(patch)` was called with an `id` for which no session has been registered.

## Fix

- Use `ctx.terminals.register(session)` to add new sessions.
- Verify the id matches an existing session — common cause is updating after `remove()`.

## Source

- [`packages/hub/src/node/host-terminals.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/host-terminals.ts) — `DevframeTerminalsHost.update()` throws when `sessions.has(patch.id) === false`.
