Skip to main content
POST
Run the consolidation pass (NDJSON stream)

Body

application/json

What to run. Every field is optional.

mode
enum<string>
default:dry_run

dry_run reports and changes nothing, and never calls a model. apply acts.

Available options:
dry_run,
apply
trigger
enum<string>
default:manual

Recorded on the run, so the history says who started it.

Available options:
manual,
idle,
startup
passes
enum<string>[]

Run exactly these passes, ignoring the saved settings. Omit to use the settings, which is what every shipped surface does. This overrides the settings for the three paid passes too, so a caller can start a run that spends money while the Settings toggles are off. RECONCILE_ENABLED=0 still refuses it.

Available options:
invariants,
entities,
llm_entities,
llm_conflicts,
llm_recheck
budgetUsd
number

Keep re-checking past the per-run ceiling until nothing is due or this much has been billed, measured against the provider's own reported cost. Omit for one page and stop, which is the default. Capped at 50 because a typo here spends real money.

Required range: x <= 50

Response

NDJSON progress stream ending with a done (or error) event.

The response is of type string.

Example:

"{\"type\":\"item\",\"runId\":\"0f2c7b18\",\"pass\":\"llm_recheck\",\"checked\":1,\"total\":200,\"found\":0}\n{\"type\":\"item\",\"runId\":\"0f2c7b18\",\"pass\":\"llm_recheck\",\"checked\":2,\"total\":200,\"found\":1}\n{\"type\":\"done\",\"run\":{\"id\":\"0f2c7b18\",\"mode\":\"apply\",\"status\":\"success\"},\"actions\":[]}\n"