Docs
ResourceApp tools

geni app run-handler

Dispatch a handler against the live app with test input.

geni app run-handler <name> [id] [flags]

Dispatches one handler against the live app with the given input and prints the full result. Bypasses the cache — the same code path the iframe takes when a user clicks something. Use it to reproduce a failure or spot-check a handler before or after a publish. Exits nonzero on a handler error.

Runs against the published app, so publish first.

Synopsis

geni app run-handler listCustomers --input '{"limit":50}'
geni app run-handler tagCustomer wf_01HX --input '{"id":"cus_1","tag":"lead"}'
Arg / FlagNotes
<name>Handler name (the name declared in app.json).
[id]App id. Omit to use the marker in --dir.
--input <json>Handler input as a JSON object. Defaults to {}.
--timeout <seconds>Server-side wait before timing out. Default 60, max 300.
--dir <path>Resource directory. Defaults to cwd.
--jsonMachine-readable output.

Inspect past runs with app invocations.

On this page