Definition replacement uses the version previously read

Context

Two people or browser tabs can edit the same definition. The write contract must detect a stale replacement.

Decision

Editable query definitions, Explorer preferences, reports, schedules, custom tables and assignments, search settings and workspace export settings require the version read by the writer.

Alternatives Considered

Accept the last write regardless of version: One writer could silently discard the other’s changes.

Consequences

A missing version is refused and an outdated version conflicts. A conflict requires a fresh read before the user can deliberately apply another edit.