Skip to main content
POST
/
v1beta
/
tasks
/
groups
Python
from parallel import Parallel

client = Parallel(api_key="API Key")

task_group = client.beta.task_group.create(metadata={"key": "value"})
print(task_group.task_group_id)
{
  "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

Body

application/json

Request to create a task group.

​
metadata
Metadata · object

User-provided metadata stored with the task group.

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.