parallel_create_task_run

Tool

Initiates a task run.Returns immediately with a run object in status ‘queued’.Beta features can be enabled by setting the ‘parallel-beta’ header.

Pricing

Per call

$0.02

Model

flat

Pay only for what you use. No subscriptions.

Inputs

input *

string

source_policy

object

mcp_servers

array

metadata

object

webhook

object

enable_events

boolean

processor *

string

task_spec

object

Try It

API

MCP Config

Input Parameters

input

Input to the task, either text or a JSON object.

source_policy

Optional source policy governing preferred and disallowed domains in web search results.

mcp_servers

Optional list of MCP servers to use for the run.To enable this feature in your requests, specify mcp-server-2025-07-17 as one of the values in parallel-beta header (for API calls) or betas param (for the SDKs).

metadata

User-provided metadata stored with the run. Keys and values must be strings with a maximum length of 16 and 512 characters respectively.

webhook

Callback URL (webhook endpoint) that will receive an HTTP POST when the run completes.This feature is not available via the Python SDK. To enable this feature in your API requests, specify the parallel-beta header with webhook-2025-08-12 value.

enable_events

processor

Task run input with additional beta fields.

task_spec

Task specification. If unspecified, defaults to auto output schema.

Cost per run

Execution cost

$0.02

Deducted from your xPay allowance

Parallel API

Tool