Skip to main content
GET
/
v1
/
tasks
/
runs
/
{run_id}
Python
from parallel import Parallel

client = Parallel(api_key="API Key")

task_run = client.task_run.retrieve("run_id")
print(task_run.status)
{
  "run_id": "trun_9907962f83aa4d9d98fd7f4bf745d654",
  "status": "running",
  "is_active": true,
  "processor": "core",
  "metadata": {
    "my_key": "my_value"
  },
  "created_at": "2025-04-23T20:21:48.037943Z",
  "modified_at": "2025-04-23T20:21:48.037943Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
run_id
string
required

Response

Successful Response

Status of a task run.

​
run_id
string
required

ID of the task run.

Examples:

"trun_e0083b6aac0544eb8686e8d2a76533d2"

​
status
enum<string>
required

Status of the run.

Available options:
queued,
action_required,
running,
completed,
failed,
cancelling,
cancelled
Examples:

"queued"

"action_required"

"running"

"completed"

"failed"

"cancelling"

"cancelled"

​
is_active
boolean
required

Whether the run is currently active, i.e. status is one of {'cancelling', 'queued', 'running'}.

​
processor
string
required

Processor used for the run.

Examples:

"base"

​
created_at
string | null
required

Timestamp of the creation of the task, as an RFC 3339 string.

Examples:

"2025-04-24T18:56:22.513132Z"

​
modified_at
string | null
required

Timestamp of the last modification to the task, as an RFC 3339 string.

Examples:

"2025-04-24T18:56:22.513132Z"

​
warnings
Warning · object[] | null

Warnings for the run, if any.

Examples:
[]
​
error
object | null

Error for the run, present only if status is 'failed'. An error message.

​
metadata
object | null

User-provided metadata stored with the run.

Examples:
{}
​
taskgroup_id
string | null

ID of the taskgroup to which the run belongs.

⌘I