Advance Clock

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.

Path Parameters
pipeline_name string — REQUIRED Unique pipeline name

Request Body — REQUIRED Milliseconds to add to NOW(); zero reads the current value, null/omitted: advance by one clock_resolution.
delta_ms int64

Responses
200 Clock advanced successfully; body contains the new NOW(). Schema — OPTIONAL now string now_ms int64
400 Clock not in http-driven mode, or malformed body. Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.
503 Pipeline is not running. Schema — OPTIONAL details Detailed error metadata. The contents of this field is determined by error_code. error_code string Error code is a string that specifies this error type. message string Human-readable error message.