Extract (Beta)
Search (Beta)
Monitor
Tasks v1
Tasks (Beta)
from parallel import Parallel
client = Parallel(api_key="API Key")
# If task run has beta output fields
task_run_result = client.beta.task_run.result(
run_id="run_id",
betas=["mcp-server-2025-07-17"]
)
print(task_run_result.output){
"run": {
"run_id": "<string>",
"status": "queued",
"is_active": true,
"processor": "<string>",
"created_at": "2025-04-24T18:56:22.513132Z",
"modified_at": "2025-04-24T18:56:22.513132Z",
"warnings": [],
"error": {
"ref_id": "<string>",
"message": "<string>",
"detail": {}
},
"metadata": {},
"taskgroup_id": "<string>"
},
"output": {
"basis": [
{
"field": "<string>",
"reasoning": "<string>",
"citations": [],
"confidence": "low"
}
],
"type": "<string>",
"content": "<string>",
"beta_fields": {}
}
}Retrieve Task Run Result
Retrieves a run result by run_id, blocking until the run is completed.
from parallel import Parallel
client = Parallel(api_key="API Key")
# If task run has beta output fields
task_run_result = client.beta.task_run.result(
run_id="run_id",
betas=["mcp-server-2025-07-17"]
)
print(task_run_result.output){
"run": {
"run_id": "<string>",
"status": "queued",
"is_active": true,
"processor": "<string>",
"created_at": "2025-04-24T18:56:22.513132Z",
"modified_at": "2025-04-24T18:56:22.513132Z",
"warnings": [],
"error": {
"ref_id": "<string>",
"message": "<string>",
"detail": {}
},
"metadata": {},
"taskgroup_id": "<string>"
},
"output": {
"basis": [
{
"field": "<string>",
"reasoning": "<string>",
"citations": [],
"confidence": "low"
}
],
"type": "<string>",
"content": "<string>",
"beta_fields": {}
}
}Authorizations
Headers
Path Parameters
Query Parameters
Response
Successful Response
- TaskRunResult
- BetaTaskRunResult
Result of a task run.
Task run object with status 'completed'.
Show child attributes
Show child attributes
ID of the task run.
Status of the run.
queued, action_required, running, completed, failed, cancelling, cancelled Whether the run is currently active, i.e. status is one of {'cancelling', 'queued', 'running'}.
Processor used for the run.
Timestamp of the creation of the task, as an RFC 3339 string.
"2025-04-24T18:56:22.513132Z"
Timestamp of the last modification to the task, as an RFC 3339 string.
"2025-04-24T18:56:22.513132Z"
Warnings for the run, if any.
Show child attributes
Show child attributes
Type of warning. Note that adding new warning types is considered a backward-compatible change.
spec_validation_warning, input_validation_warning, warning Human-readable message.
Optional detail supporting the warning.
[]ID of the taskgroup to which the run belongs.
Output from the task conforming to the output schema.
- TaskRunTextOutput
- TaskRunJsonOutput
Show child attributes
Show child attributes
Basis for the output. The basis has a single field 'output'.
Show child attributes
Show child attributes
Name of the output field.
Reasoning for the output field.
List of citations supporting the output field.
Confidence level for the output field. Only certain processors provide confidence levels.
"low"
The type of output being returned, as determined by the output schema of the task spec.
"text"Text output from the task.
Additional fields from beta features used in this task run. When beta features are specified during both task run creation and result retrieval, this field will be empty and instead the relevant beta attributes will be directly included in the BetaTaskRunJsonOutput or corresponding output type. However, if beta features were specified during task run creation but not during result retrieval, this field will contain the dump of fields from those beta features.
Each key represents the beta feature version (one amongst parallel-beta headers) and the values correspond to the beta feature attributes, if any. For now, only MCP server beta features have attributes. For example, {mcp-server-2025-07-17: [{'server_name':'mcp_server', 'tool_call_id': 'tc_123', ...}]}}