Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2025-01-16170291390.7 KB
Task Run States

Read Task Run States

Get states associated with a task run.

get/api/task_run_states/

Query parameters

task_run_idstring uuid required

Headers

x-prefect-api-versionstring

Response

Successful Response

idstring uuid
type'SCHEDULED' | 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'CRASHED' | 'PAUSED' | 'CANCELLING' required

Enumeration of state types.

namestring
timestampstring date-time
messagestring
{"stackTrail":"components:schemas:State:properties:data","oasType":"schema","type":"unknown","title":"Data","description":"Data associated with the state, e.g. a result. Content must be storable as JSON."}

Example response

[
  {
    "message": "Run started"
  }
]