Task Runs
Task Run History
Query for task run history data across a given range and interval.
POST
/
api
/
task_runs
/
history
Headers
x-prefect-api-version
string
Body
application/json
history_start
string
requiredThe history's start time.
history_end
string
requiredThe history's end time.
history_interval
number
requiredThe size of each history interval, in seconds. Must be at least 1 second.
flows
object
Filter for flows. Only flows matching all criteria will be returned.
flow_runs
object
Filter flow runs. Only flow runs matching all criteria will be returned
task_runs
object
Filter task runs. Only task runs matching all criteria will be returned
deployments
object
Filter for deployments. Only deployments matching all criteria will be returned.
Response
200 - application/json
interval_start
string
requiredThe start date of the interval.
interval_end
string
requiredThe end date of the interval.
states
object[]
requiredA list of state histories during the interval.
Was this page helpful?