> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Task Run Input > Retrieves the input of a run by run_id. ## OpenAPI ````yaml openapi/parallel.ai.json GET /apis/v1/parallel/tasks/runs/{run_id}/input openapi: 3.1.0 info: description: '' title: Parallel.ai version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/parallel/chat/completions - /apis/v1/parallel/extract - /apis/v1/parallel/findall/ingest - /apis/v1/parallel/findall/runs/{findall_id} - /apis/v1/parallel/findall/runs/{findall_id}/cancel - /apis/v1/parallel/findall/runs/{findall_id}/events - /apis/v1/parallel/findall/runs/{findall_id}/result - /apis/v1/parallel/findall/runs/{findall_id}/schema - /apis/v1/parallel/monitors/{monitor_id} - /apis/v1/parallel/monitors/{monitor_id}/cancel - /apis/v1/parallel/monitors/{monitor_id}/events - /apis/v1/parallel/monitors/{monitor_id}/update - /apis/v1/parallel/tasks/groups - /apis/v1/parallel/tasks/groups/{taskgroup_id} - /apis/v1/parallel/tasks/groups/{taskgroup_id}/events - /apis/v1/parallel/tasks/groups/{taskgroup_id}/runs/{run_id} - /apis/v1/parallel/tasks/runs/{run_id} - /apis/v1/parallel/tasks/runs/{run_id}/events - /apis/v1/parallel/tasks/runs/{run_id}/input - /apis/v1/parallel/tasks/runs/{run_id}/result - /apis/v1/parallel/v1beta/tasks/runs/{run_id}/events x-aisa-document: facts_hash: 7d3bf2025708131927d3136de215ba314114253046b35f239876910b2481cbd9 generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: [] document_hash: sha256:dae9e982424f710c06d9af023168dd26ed96bf5e5b5232e0728c01867d2da7dc x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: parallel.ai x-aisa-catalogs: parallel.ai: title: Parallel.ai description: '' x-aisa-document: facts_hash: 7d3bf2025708131927d3136de215ba314114253046b35f239876910b2481cbd9 generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/parallel/tasks/runs/{run_id}/input: get: tags: - default summary: Retrieve Task Run Input description: Retrieves the input of a run by run_id. operationId: any_parallel_ai_apis_v1_parallel_tasks_runs_run_id_input parameters: - name: run_id in: path required: true schema: type: string title: Run Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunInput' example: processor: core metadata: my_key: my_value task_spec: output_schema: json_schema: type: object properties: gdp: type: string description: >- GDP in USD for the year, formatted like '$3.1 trillion (2023)' required: - gdp additionalProperties: false type: json input_schema: json_schema: type: object properties: country: type: string year: type: integer required: - country - year additionalProperties: false type: json input: country: France year: 2023 default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseB67C75A8Feba_TaskRunInput: properties: processor: type: string title: Processor description: Processor to use for the task. examples: - base metadata: anyOf: - additionalProperties: anyOf: - type: string - type: integer - type: number - type: boolean type: object - type: 'null' title: Metadata description: >- User-provided metadata stored with the run. Keys and values must be strings with a maximum length of 16 and 512 characters respectively. memory_scope_key: anyOf: - type: string maxLength: 128 minLength: 1 pattern: ^[a-zA-Z0-9_-]+$ - type: 'null' title: Memory Scope Key description: >- User-provided key identifying the memory scope to use. Omit to use personal memory, if available. source_policy: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_SourcePolicy' - type: 'null' description: >- Optional source policy governing included and excluded domains and domain/path prefixes in web search results. advanced_settings: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskAdvancedSettings' - type: 'null' description: Advanced search configuration for the task run. task_spec: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskSpec' - type: 'null' description: Task specification. If unspecified, defaults to auto output schema. input: anyOf: - type: string - additionalProperties: true type: object title: Input description: Input to the task, either text or a JSON object. examples: - What was the GDP of France in 2023? - '{"country": "France", "year": 2023}' previous_interaction_id: anyOf: - type: string - type: 'null' title: Previous Interaction Id description: Interaction ID to use as context for this request. mcp_servers: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_McpServer' type: array - type: 'null' title: Mcp Servers description: Optional list of MCP servers to use for the run. enable_events: anyOf: - type: boolean - type: 'null' title: Enable Events description: >- Controls tracking of task run execution progress. When set to true, progress events are recorded and can be accessed via the [Task Run events](https://docs.parallel.ai/api-reference) 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). webhook: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_Webhook' - type: 'null' description: >- Callback URL (webhook endpoint) that will receive an HTTP POST when the run completes. This feature is not available via the Python SDK. type: object required: - processor - input title: TaskRunInput description: Request to run a task. ResponseB67C75A8Feba_SourcePolicy: properties: include_domains: items: type: string type: array title: Include Domains description: >- List of domains or domain/path prefixes to restrict results to. If specified, only matching sources will be included and exclude_domains will be ignored. Accepts plain domains (e.g., wikipedia.org), domain/path prefixes (e.g., docs.python.org/3), or bare domain extensions (e.g., .gov, .edu, .co.uk). The combined number of entries in include_domains and exclude_domains cannot exceed 200. examples: - - wikipedia.org - docs.python.org/3 - .edu exclude_domains: items: type: string type: array title: Exclude Domains description: >- List of domains or domain/path prefixes to exclude from results. Applied only when include_domains is empty. If specified, matching sources will be excluded. Accepts plain domains (e.g., reddit.com), domain/path prefixes (e.g., youtube.com/shorts), or bare domain extensions (e.g., .gov, .edu, .co.uk). The combined number of entries in include_domains and exclude_domains cannot exceed 200. examples: - - reddit.com - youtube.com/shorts - .ai after_date: anyOf: - type: string format: date - type: 'null' title: After Date description: >- Optional start date for filtering search results. Results will be limited to content published on or after this date. Provided as an RFC 3339 date string (YYYY-MM-DD). examples: - '2024-01-01' type: object title: SourcePolicy description: >- Source policy for web search results. Plain domains match that domain and its subdomains. Domain/path entries use case-sensitive path matching at segment boundaries; trailing slashes are ignored, dot segments are normalized, and other percent-encoded path spelling is preserved. Entries omit schemes, ports, query strings, and fragments. When include_domains is non-empty, it defines the complete allowlist and exclude_domains is ignored. ResponseB67C75A8Feba_TaskAdvancedSettings: properties: location: anyOf: - type: string - type: 'null' title: Location description: ISO 3166-1 alpha-2 country code for geo-targeted search results. examples: - us - gb - de - jp data_sources: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskDataSources' - type: 'null' description: >- Optional partner data sources to enable for this task run. Supported on standard processors only; a selected partner name must not collide with an `mcp_servers` entry. type: object title: TaskAdvancedSettings description: Advanced search configuration for a task run. ResponseB67C75A8Feba_TaskSpec: properties: output_schema: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_JsonSchema' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TextSchema' - $ref: '#/components/schemas/ResponseB67C75A8Feba_AutoSchema' - type: string title: Output Schema description: >- JSON schema or text fully describing the desired output from the task. Descriptions of output fields will determine the form and content of the response. A bare string is equivalent to a text schema with the same description. input_schema: anyOf: - type: string - $ref: '#/components/schemas/ResponseB67C75A8Feba_JsonSchema' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TextSchema' - type: 'null' title: Input Schema description: >- Optional JSON schema or text description of expected input to the task. A bare string is equivalent to a text schema with the same description. type: object required: - output_schema title: TaskSpec description: >- Specification for a task. Auto output schemas can be specified by setting `output_schema={"type":"auto"}`. Not specifying a TaskSpec is the same as setting an auto output schema. For convenience bare strings are also accepted as input or output schemas. ResponseB67C75A8Feba_McpServer: properties: type: type: string const: url title: Type description: Type of MCP server being configured. Always `url`. default: url url: type: string title: Url description: URL of the MCP server. headers: anyOf: - additionalProperties: type: string format: password writeOnly: true type: object - type: 'null' title: Headers description: Headers for the MCP server. name: type: string title: Name description: Name of the MCP server. allowed_tools: anyOf: - items: type: string type: array - type: 'null' title: Allowed Tools description: List of allowed tools for the MCP server. type: object required: - url - name title: McpServer description: MCP server configuration. ResponseB67C75A8Feba_Webhook: properties: url: type: string title: Url description: URL for the webhook. event_types: items: type: string enum: - task_run.status type: array title: Event Types description: Event types to send the webhook notifications for. default: [] type: object required: - url title: Webhook description: Webhooks for Task Runs. ResponseB67C75A8Feba_TaskDataSources: properties: pay_per_use: items: type: string type: array title: Pay Per Use description: >- Pay-per-use data partners to enable for this task, in addition to sources included with the processor. See the Data Sources documentation for the available names. free: items: type: string type: array title: Free description: >- Free data partners to enable for this task, in addition to sources included with the processor. Never billed. See the Data Sources documentation for the available names. additionalProperties: false type: object title: TaskDataSources ResponseB67C75A8Feba_JsonSchema: properties: json_schema: additionalProperties: true type: object title: Json Schema description: A JSON Schema object. Only a subset of JSON Schema is supported. examples: - additionalProperties: false properties: gdp: description: >- GDP in USD for the year, formatted like '$3.1 trillion (2023)' type: string required: - gdp type: object type: type: string const: json title: Type description: The type of schema being defined. Always `json`. default: json type: object required: - json_schema title: JsonSchema description: JSON schema for a task input or output. ResponseB67C75A8Feba_TextSchema: properties: description: anyOf: - type: string - type: 'null' title: Description description: A text description of the desired output from the task. examples: - GDP in USD for the year, formatted like '$3.1 trillion (2023)' type: type: string const: text title: Type description: The type of schema being defined. Always `text`. default: text type: object title: TextSchema description: Text description for a task input or output. ResponseB67C75A8Feba_AutoSchema: properties: type: type: string const: auto title: Type description: The type of schema being defined. Always `auto`. default: auto type: object title: AutoSchema description: Auto schema for a task input or output. securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.