TinyFish Web Agent icon

TinyFish Web Agent

Extract data, fill forms, and automate multi-step browser workflows using natural language

Actions5

List Runs

AI-generated

Summary

List automation runs, optionally filtered by status and limited in count.

Inputs

  • returnAll — Whether to return all results or only up to a given limit. Defaults to false.
  • limit — Maximum number of runs to return. Ignored when returnAll is true. Accepts values 1–100. Defaults to 20 when returnAll is false and no explicit limit is set by the workflow builder, but the node applies a default of 20 in the API request when returnAll is false and limit is not overridden; the UI limits the control to 1–100 with a default of 20, and the parameter is only shown when returnAll is false and operation is listRuns.
  • filters — Optional collection of filters to narrow the runs returned. Currently supports a single option: status. Defaults to an empty filter (no status restriction). When a status is selected, only runs matching that status are included.

Output shape

An array of run objects as returned by the TinyFish API. Each item in the output array represents one run and contains the run's JSON data. The array length depends on the parameters: when returnAll is true, up to 10,000 runs are returned across paginated API requests; otherwise, up to the specified limit (default 20) of runs are returned. Runs are paired with their originating item index for workflow data mapping.

The status filter, if provided, is sent as the status query parameter to the /v1/runs endpoint. The API returns runs matching that status. If no filter is provided (empty/default), all runs are returned subject to the limit.

Links

Discussion