# X_ENTITY_READ_ONLY

## Means

a read-only entity was asked to write a row

## Typical cause

entity({ readOnly: '<why>' }) declares a table the app only reads — legacy history, a table another system owns — and its repository refuses every insert, update, upsert, delete and lock before any statement

## Fix

`x entities show <entity> --json` — the readOnly reason says why; write the table the app owns, or drop readOnly from entity('<entity>', { … }) when it is writable again

[Entity and database](/error-codes#entity-and-database)
