Parallel Create Task Run
parallel_create_task_runInitiates a task run.Returns immediately with a run object in status ‘queued’.Beta features can be enabled by setting the ‘parallel-beta’ header.
When to Use
Use this tool when you need to initiates a task run.returns immediately with a run object in status ‘queued’.beta features can be enabled by setting the ‘parallel-beta’ header.. This is part of the Parallel API provider on xpay✦.
MCP Connection
Connect to xpay✦ to access this tool (and 11+ others):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
How to Execute
Use the xpay✦ meta-tools to run this tool:
xpay_details— Get full input schema:xpay_details("parallel/parallel_create_task_run")xpay_run— Execute:xpay_run("parallel/parallel_create_task_run", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
input | string | Yes | Input to the task, either text or a JSON object. |
source_policy | object | No | Optional source policy governing preferred and disallowed domains in web search results. |
mcp_servers | array | No | 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 | object | No | User-provided metadata stored with the run. Keys and values must be strings with a maximum length of 16 and 512 characters respectively. |
webhook | object | No | 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 | boolean | No | Controls tracking of task run execution progress. When set to true, progress events are recorded and can be accessed via the Task Run events endpoint. When false, no progress events are tracked. Note that progress tracking cannot be enabled after a run has been created. The flag is set to true by default for premium processors (pro and above).To enable this feature in your requests, specify events-sse-2025-07-24 as one of the values in parallel-beta header (for API calls) or betas param (for the SDKs). |
processor | string | Yes | Task run input with additional beta fields. |
task_spec | object | No | Task specification. If unspecified, defaults to auto output schema. |
Pricing
- Cost: $0.02/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Parallel API (all tools) — 12 tools
- Parallel Chat Api — $0.02/call
- Parallel Search — $0.02/call
- Parallel Extract — $0.02/call
- Parallel Retrieve Findall Run Status — $0.01/call
- Parallel Findall Run Result — $0.01/call
Links
- Tool page: https://xpay.tools/parallel/parallel-create-task-run/
- Provider: https://xpay.tools/parallel/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
input | string | Yes | Input to the task, either text or a JSON object. |
source_policy | object | No | Optional source policy governing preferred and disallowed domains in web search results. |
mcp_servers | array | No | 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 | object | No | User-provided metadata stored with the run. Keys and values must be strings with a maximum length of 16 and 512 characters respectively. |
webhook | object | No | 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 | boolean | No | Controls tracking of task run execution progress. When set to true, progress events are recorded and can be accessed via the Task Run events endpoint. When false, no progress events are tracked. Note that progress tracking cannot be enabled after a run has been created. The flag is set to true by default for premium processors (pro and above).To enable this feature in your requests, specify events-sse-2025-07-24 as one of the values in parallel-beta header (for API calls) or betas param (for the SDKs). |
processor | string | Yes | Task run input with additional beta fields. |
task_spec | object | No | Task specification. If unspecified, defaults to auto output schema. |
Install Skill
Pricing
Cost
$0.02/call
Model
Flat rate
Provider
Parallel API