v50

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

Read Flow Run State

Get a flow run state by id.

get/api/flow_run_states/{id}

Path parameters

idstring uuid required

The flow run state id

The flow run state id

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"
}