POST
/
v1beta
/
tasks
/
groups
/
{taskgroup_id}
/
runs
Add Runs to Task Group
curl --request POST \
  --url https://api.parallel.ai/v1beta/tasks/groups/{taskgroup_id}/runs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "default_task_spec": {
    "output_schema": {
      "json_schema": {
        "additionalProperties": false,
        "properties": {
          "gdp": {
            "description": "GDP in USD for the year, formatted like '\''$3.1 trillion (2023)'\''",
            "type": "string"
          }
        },
        "required": [
          "gdp"
        ],
        "type": "object"
      },
      "type": "json"
    },
    "input_schema": "<string>"
  },
  "inputs": [
    {
      "task_spec": {
        "output_schema": {
          "json_schema": {
            "additionalProperties": false,
            "properties": {
              "gdp": {
                "description": "GDP in USD for the year, formatted like '\''$3.1 trillion (2023)'\''",
                "type": "string"
              }
            },
            "required": [
              "gdp"
            ],
            "type": "object"
          },
          "type": "json"
        },
        "input_schema": "<string>"
      },
      "input": "What was the GDP of France in 2023?",
      "processor": "base",
      "metadata": {},
      "source_policy": {
        "include_domains": "wikipedia.org",
        "exclude_domains": "reddit.com"
      }
    }
  ]
}'
{
  "status": {
    "num_task_runs": 123,
    "task_run_status_counts": {},
    "is_active": true,
    "status_message": "<string>",
    "modified_at": "2025-04-24T18:56:22.513132Z"
  },
  "run_ids": [
    "<string>"
  ],
  "run_cursor": "<string>",
  "event_cursor": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
taskgroup_id
string
required

Body

application/json

Request to initiate new task runs in a task group.

Response

200
application/json

Successful Response

Response from adding new task runs to a task group.