Skip to main content
When a run reaches a point where it needs something a person must supply — an approval, a missing value, a decision — it raises an input request and pauses instead of guessing.

​
input-requests list

​
input-requests show

Show the full detail of a request, including which fields it wants.
Read this before submitting so you know the field names and what each one expects.

​
input-requests submit

Submit values and let the run continue.
​
required
A JSON object of field values.
​
default:"cli"
Surface identifier, recorded with the submission.
​
Emit as JSON.
The id can be an input-request UUID, or an agent handle, UUID, or FQN. Given an agent, it resolves to that agent’s single open request — and errors rather than guessing if there is none, or more than one.

​
input-requests cancel

Cancel an open request. The run it belongs to won’t proceed past that point.
​
default:"user_cancelled"
Why the request was cancelled. Recorded with the cancellation.

​
During a run

jstm agent run prints the exact show and submit commands when it hits a blocked input request, so you can unblock it without looking anything up.

​
See also