GET
/
v1beta
/
tasks
/
groups
/
{taskgroup_id}
/
runs
Stream Task Group Runs
curl --request GET \
  --url https://api.parallel.ai/v1beta/tasks/groups/{taskgroup_id}/runs \
  --header 'x-api-key: <api-key>'
{
  "type": "task_run.state",
  "event_id": "123",
  "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"
  },
  "input": {
    "input": {
      "country": "France",
      "year": 2023
    },
    "processor": "core",
    "metadata": {
      "my_key": "my_value"
    }
  }
}

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

200
text/event-stream

Successful Response

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

May indicate completion, cancellation, or failure.