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>",
  "metadata": {},
  "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"
}

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
object
required

Status of the group. Status of a task group.

​
created_at
string | null
required

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

Examples:

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

​
metadata
object | null

User-provided metadata stored with the group.

⌘I