Skip to main content
GET
/
v1beta
/
tasks
/
groups
/
{taskgroup_id}
/
runs
Python
from parallel import Parallel

client = Parallel(api_key="API Key")

task_group_runs = client.beta.task_group.get_runs("taskgroup_id")
for run in task_group_runs:
    print(run)
{
  "type": "task_run.state",
  "event_id": "123",
  "input": {
    "input": {
      "country": "France",
      "year": 2023
    },
    "processor": "core",
    "metadata": {
      "my_key": "my_value"
    }
  },
  "run": {
    "run_id": "trun_9907962f83aa4d9d98fd7f4bf745d654",
    "status": "completed",
    "is_active": false,
    "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

​
taskgroup_id
string
required

Query Parameters

​
last_event_id
string | null
​
status
enum<string> | null
Available options:
queued,
action_required,
running,
completed,
failed,
cancelling,
cancelled
​
include_input
boolean
default:false
​
include_output
boolean
default:false

Response

Successful Response

  • TaskRunEvent
  • ErrorEvent

Event when a task run transitions to a non-active status.

May indicate completion, cancellation, or failure.

​
type
enum<string>
required

Event type; always 'task_run.state'.

Available options:
TitleConst
Typetask_run.state
​
event_id
string | null
required

Cursor to resume the event stream. Always empty for non Task Group runs.

​
run
object
required

Task run object. Status of a task run.

​
input
object | null

Input to the run; included only if requested. Task run input with additional beta fields.

​
output
object | null

Output from the run; included only if requested and if status == completed. Output from a task that returns text.

  • TaskRunTextOutput
  • TaskRunJsonOutput
⌘I