Python
from parallel import Parallel
client = Parallel()
task_group = client.task_group.create(metadata={"key": "value"})
print(task_group.task_group_id)import Parallel from "parallel-web";
const client = new Parallel();
const taskGroup = await client.taskGroup.create({
metadata: {'key': 'value'},
});
console.log(taskGroup.taskgroup_id);curl --request POST \
--url https://api.parallel.ai/v1/tasks/groups \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"metadata": {}
}'{
"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": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Tasks
Create Task Group
Initiates a TaskGroup to group and track multiple runs.
POST
/
v1
/
tasks
/
groups
Python
from parallel import Parallel
client = Parallel()
task_group = client.task_group.create(metadata={"key": "value"})
print(task_group.task_group_id)import Parallel from "parallel-web";
const client = new Parallel();
const taskGroup = await client.taskGroup.create({
metadata: {'key': 'value'},
});
console.log(taskGroup.taskgroup_id);curl --request POST \
--url https://api.parallel.ai/v1/tasks/groups \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"metadata": {}
}'{
"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": {}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Body
application/json
Response
Successful Response
Response object for a task group, including its status and metadata.