Error codes

STALE_EPOCH

The request was based on an earlier version of the data.

Exit code: 6 · Who acts: You or another person, after you read the current state, or by waiting · From: the CLI, the SDK and the backend

What it means

The request was based on an earlier version of the data.

Common causes

  • Something changed between your read and your write.

Fix it

  1. Read the item again, then retry.

In JSON and the SDK

With --json, the CLI prints:

{
  "outcome": "refused",
  "error": {
    "code": "STALE_EPOCH",
    "message": "…"
  }
}

In the SDK, a failed result has result.error.code === "STALE_EPOCH". Branch on the code, not on the message: the message is written for people and can change.

Commands that can answer with it

No command lists this code. It can still come from the SDK or the backend.

On this page