Skip to main content
POST
Paginate Task Runs

Headers

x-prefect-api-version
string

Body

application/json
sort
enum<string>
default:ID_DESC

Defines task run sorting options.

Available options:
ID_DESC,
EXPECTED_START_TIME_ASC,
EXPECTED_START_TIME_DESC,
NAME_ASC,
NAME_DESC,
NEXT_SCHEDULED_START_TIME_ASC,
END_TIME_DESC
page
integer
default:1
Required range: x >= 1
flows
FlowFilter · object | null

Filter for flows. Only flows matching all criteria will be returned.

flow_runs
FlowRunFilter · object | null

Filter flow runs. Only flow runs matching all criteria will be returned

task_runs
TaskRunFilter · object | null

Filter task runs. Only task runs matching all criteria will be returned

deployments
DeploymentFilter · object | null

Filter for deployments. Only deployments matching all criteria will be returned.

limit
integer

Defaults to PREFECT_API_DEFAULT_LIMIT if not provided.

Response

Successful Response

results
TaskRunResponse · object[]
required
count
integer
required
limit
integer
required
pages
integer
required
page
integer
required