> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.whalehunt.net/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.whalehunt.net/_mcp/server.

# Retention, backups and reset

Replay redelivers events already stored in the available journal interval. It does not reconstruct every unobserved source event.

## Check the boundary

`hello.retention.resumeFloor` is the exclusive lower boundary of `(resumeFloor,committedFrontier]`. A cursor exactly on the floor is valid: the next batch is retained. A cursor below it is expired.

The applicable retention policy is arranged with access. The floor describes a current history boundary, not a fixed number of hours. Handle expiry even when an integration has an agreed retention duration.

| Mechanism               | Purpose                             | Limit                                                    |
| ----------------------- | ----------------------------------- | -------------------------------------------------------- |
| Retained journal/replay | Catch up after a disconnect         | Does not establish survival of total origin storage loss |
| Independent backup      | Recover the service after host loss | Can lack events written after the backup                 |
| Client checkpoint       | Resume local processing             | Does not itself retain missing event payloads            |

Backup frequency alone is not an RPO: successful transfer and verified restoration matter. This documentation does not promise zero history loss after host loss.

## Handle reset\_required

Stop automatic continuation of the old history. Record code, stream/history generation and floor without exposing the token. Determine the available history with the operator. Only an explicit decision can choose a new `live_cut`, with the gap recorded in local state.

`permittedActions` contains `discover_current_history` and `explicit_live_cut`. These are actions, not existing REST endpoints. `history_unavailable` can have `retainedFloor: null`.

See [errors and reset](/polymarket/reference/errors). Do not display a continuous history after silently discarding its missing interval.