Metrics & Debugging

Advance Clock

Required role: write or higher.

Moves NOW() forward by a specified amount. Returns the current clock time of the circuit.

Requires dev_tweaks.now_http_driven = true on the pipeline.

Forward-only: delta_ms is u64, so negative bodies are rejected at JSON parse time. delta_ms = null or omitted advances by one clock_resolution. Non-zero values round up to the next clock_resolution boundary, so a sub-resolution delta still moves the clock by one full tick.

The returned now_ms is the value the worker will emit on its next pipeline step; queries against materialized views may observe the previous NOW() until that step completes. Callers that need read-after-write semantics should poll the view.

post/v0/pipelines/{pipeline_name}/clock/advance

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Path parameters

pipeline_namestring required

Unique pipeline name

Request body

delta_msinteger nullable

Response

Clock advanced successfully; body contains the new NOW().

nowstring required
now_msinteger required

Changes

No recorded changes to this operation across all 51 revisions of this API.