Docs › Make scenarios with RunVouch

Make scenarios with RunVouch

A Make scenario on a schedule runs until Make deactivates it after consecutive errors, or until someone toggles it off. The deactivation e-mail is easy to miss, and a scenario that runs with zero bundles is a normal run.

How it runs on Make (Integromat)

Two HTTP modules in the scenario: one at the start, one at the end, with the API's JSON.

Store the key

Store the key in a Make connection or as a scenario variable; put it in the X-API-Key header of both HTTP modules.

Report the run (two HTTP calls)

# 1. at the start of the job
curl -s -X POST https://api.runvouch.com/v1/runs/start -H "X-API-Key: $RUNVOUCH_KEY" \
  -H "content-type: application/json" -d '{"agent":"lead-enricher","source":"make"}'
# -> {"run_id":"..."}

# 2. at the end, with what you know: status, cost, evidence
curl -s -X POST https://api.runvouch.com/v1/runs/end -H "X-API-Key: $RUNVOUCH_KEY" \
  -H "content-type: application/json" \
  -d '{"run_id":"...","status":"ok","cost":0.12,"evidence":{"rows_written":true}}'

The start call returns run_id; the end call takes status (ok or fail), optional cost and tokens, and evidence as a JSON object of booleans. Full reference on the API page.

Register the cadence and caps

rv agent nightly-report --cadence 24h --grace 30m --max-runtime 1h --evidence --cap-run-cost 2

Register the agent once, from anywhere with the key. Cadence is what turns a schedule that stopped into an alert; --evidence makes a run without evidence a failure; the caps pause the agent when it overspends.

What goes silent on Make (Integromat)

What RunVouch detects

AlertWhat it means here
MISSEDcadence plus grace passed and no run started
FAILEDnon-zero exit or a reported failure, with the stderr excerpt
NO_EVIDENCEthe run said ok but the file, URL or assertion you required is missing
STALLEDa run started and never ended within max runtime
RETRY_STORMthe same tool called with identical input many times in one run
BUDGET_RUN / BUDGET_DAYcost cap crossed; the agent is paused until you resume it
DRIFTduration or output size far off its 7-run baseline

Need a key? Get a free key · Stuck? contact