> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joystream.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# jstm input-requests

> Answer an agent that has paused waiting for information from a person.

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`

```bash theme={null}
jstm input-requests list
jstm input-requests list --status open --agent-id month-end-close
```

| Option       | Description                                                                     |
| ------------ | ------------------------------------------------------------------------------- |
| `--status`   | Filter by `open`, `partially_submitted`, `satisfied`, `cancelled`, or `expired` |
| `--agent-id` | Filter by agent                                                                 |
| `--json`     | Emit as JSON                                                                    |

## `input-requests show`

Show the full detail of a request, including which fields it wants.

```bash theme={null}
jstm input-requests show 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa
```

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.

```bash theme={null}
jstm input-requests submit 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa \
  --values '{"approver":"dana@acme.com","note":"Approved for July close"}'
```

<ParamField path="--values" required>
  A JSON object of field values.
</ParamField>

<ParamField path="--surface" default="cli">
  Surface identifier, recorded with the submission.
</ParamField>

<ParamField path="--json">
  Emit as JSON.
</ParamField>

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.

```bash theme={null}
jstm input-requests submit month-end-close --values '{"approver":"dana@acme.com"}'
```

## `input-requests cancel`

Cancel an open request. The run it belongs to won't proceed past that point.

```bash theme={null}
jstm input-requests cancel 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa
jstm input-requests cancel 9b74e2a1-… --reason "Superseded by manual close"
```

<ParamField path="--reason" default="user_cancelled">
  Why the request was cancelled. Recorded with the cancellation.
</ParamField>

## 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

* [Agent inputs](/features/agent-inputs) — how inputs are declared and validated.
* [Blocked or failing runs](/troubleshooting/runs)