Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Hiloop API key sent as an HTTP Bearer token.

Query Parameters

page_size
integer<int32>

The maximum number of runs to return. The server caps and defaults this; 0 means "use the server default".

page_token
string

An opaque page token from a previous response's next_page_token. Empty for the first page.

status
string

Optional run status filter (pending, running, succeeded, failed, canceled). Empty returns all.

created_by
string

Optional creator filter: the stable principal id (API key or user) that created the run. Empty returns runs from any creator.

created_after
string

Optional lower bound on created_at (RFC 3339, inclusive). Empty applies no lower bound.

created_before
string

Optional upper bound on created_at (RFC 3339, exclusive). Empty applies no upper bound.

root_run_id
string

Optional run-tree filter: restrict to the runs whose root_run_id matches. Empty returns runs across every tree.

project_id
string

Optional project filter: restrict to the runs belonging to this project. Empty returns runs across every project.

executing_principal
string

Optional executing-identity filter: the stable principal id the runs execute as — a registered workload's id to list that workload's runs. Empty applies no executing-identity filter.

Response

OK

runs
object[]

The runs on this page, newest first.

next_page_token
string

The token to pass as page_token to fetch the next page. Empty when there are no more results.