Skip to main content
GET
/
api
/
task_runs
/
{id}
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created": "2023-11-07T05:31:56Z",
  "updated": "2023-11-07T05:31:56Z",
  "name": "my-task-run",
  "flow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_key": "<string>",
  "dynamic_key": "<string>",
  "cache_key": "<string>",
  "cache_expiration": "2023-11-07T05:31:56Z",
  "task_version": "<string>",
  "empirical_policy": {
    "max_retries": 0,
    "retry_delay_seconds": 0,
    "retries": 123,
    "retry_delay": 123,
    "retry_jitter_factor": 123
  },
  "tags": [
    "tag-1",
    "tag-2"
  ],
  "labels": {
    "key": "value1",
    "key2": 42
  },
  "state_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "task_inputs": {},
  "state_type": "SCHEDULED",
  "state_name": "<string>",
  "run_count": 0,
  "flow_run_run_count": 0,
  "expected_start_time": "2023-11-07T05:31:56Z",
  "next_scheduled_start_time": "2023-11-07T05:31:56Z",
  "start_time": "2023-11-07T05:31:56Z",
  "end_time": "2023-11-07T05:31:56Z",
  "total_run_time": 0,
  "estimated_run_time": 0,
  "estimated_start_time_delta": 0,
  "state": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "SCHEDULED",
    "name": "<string>",
    "timestamp": "2023-11-07T05:31:56Z",
    "message": "Run started",
    "data": "<any>",
    "state_details": {
      "flow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "task_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "child_flow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "scheduled_time": "2023-11-07T05:31:56Z",
      "cache_key": "<string>",
      "cache_expiration": "2023-11-07T05:31:56Z",
      "deferred": true,
      "untrackable_result": false,
      "pause_timeout": "2023-11-07T05:31:56Z",
      "pause_reschedule": false,
      "pause_key": "<string>",
      "run_input_keyset": {},
      "refresh_cache": true,
      "retriable": true,
      "transition_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "task_parameters_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "traceparent": "<string>",
      "deployment_concurrency_lease_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  }
}

Headers

x-prefect-api-version
string

Path Parameters

id
string<uuid>
required

Response

id
string<uuid>
required
created
string<date-time> | null
required
updated
string<date-time> | null
required
task_key
string
required
dynamic_key
string
required
name
string
Examples:
flow_run_id
string<uuid> | null
cache_key
string | null
cache_expiration
string<date-time> | null
task_version
string | null
empirical_policy
object
tags
string[]
Examples:
labels
object | null
Examples:
state_id
string<uuid> | null
task_inputs
object
state_type
enum<string> | null
Available options:
SCHEDULED,
PENDING,
RUNNING,
COMPLETED,
FAILED,
CANCELLED,
CRASHED,
PAUSED,
CANCELLING
state_name
string | null
run_count
integer
default:0
flow_run_run_count
integer
default:0
expected_start_time
string<date-time> | null
next_scheduled_start_time
string<date-time> | null
start_time
string<date-time> | null
end_time
string<date-time> | null
total_run_time
number
default:0
estimated_run_time
number
default:0
estimated_start_time_delta
number
default:0
state
object | null