Skip to main content
GET/api/public/v1/runs

runs.list

Runs newest first; filter by flow, schedule, status (or open = not finished) and created before a time.

Capability: workflow.readMCP tool: runs_list
View as Markdown

Parameters

NameTypeRequiredDescription
flow_idquerystring (uuid)No
schedule_idquerystring (uuid)No
statusquery"open" | "queued" | "starting" | "running" | "pause_requested" | "paused" | "stop_requested" | "succeeded" | …Noopen = not finished yet
beforequerystring (date-time)NoOnly runs created before this time (next page: created_at of the last row)
limitqueryintegerNo(min 1, max 200) Default: `50`.

Examples

curl "https://browlix.com/api/public/v1/runs" \
  -H "Authorization: Bearer $BROWLIX_API_KEY"

Response

200 with { data, correlation_id }.

The field list of this reply is not published yet; read data as JSON.

Errors

CodeHTTPRetryable
UNAUTHENTICATED401No
FORBIDDEN403No
RATE_LIMITED429Yes
VALIDATION_FAILED422No
DEPENDENCY_UNAVAILABLE503Yes
UNKNOWN500No

Every error code and when to retry

All operations