sheets

Force an immediate flush of a Sheet's pending WAL ("Sync now").

Forces an immediate flush of the sheet's pending write-ahead log, ignoring the server-side per-sheet age gate the periodic background flush job otherwise waits out (DVT-3374). Requires sheet:write — the same authorization chain as POST /v1/sheets/{id}/rows.

Concurrent callers are safe: an on-demand flush shares the same per-sheet single-flight advisory lock as the periodic background flush job, so a caller racing an in-progress flush (from another instance, or the background job) receives busy rather than double-flushing or blocking.

post/v1/sheets/{id}/flush

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/sheets/{id}/flush
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Response

The flush attempt's outcome.

Changes

No recorded changes to this operation across all 1 revision of this API.