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

client = Parallel(api_key="API Key")

task_group = client.beta.task_group.retrieve("taskgroup_id")
print(task_group.status)
{
  "taskgroup_id": "<string>",
  "status": {
    "num_task_runs": 123,
    "task_run_status_counts": {},
    "is_active": true,
    "status_message": "<string>",
    "modified_at": "2025-04-24T18:56:22.513132Z"
  },
  "created_at": "2025-04-24T18:56:22.513132Z",
  "metadata": {}
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
taskgroup_id
string
required

Response

Successful Response

Response object for a task group, including its status and metadata.

​
taskgroup_id
string
required

ID of the group.

​
status
TaskGroupStatus · object
required

Status of the group.

​
created_at
string | null
required

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

Example:

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

​
metadata
Metadata · object

User-provided metadata stored with the group.