> ## 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. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Retrieve Task Run Input > Retrieves the input of a run by run_id. Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** GET /apis/v1/parallel/tasks/runs/\{run\_id}/input * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/parallel/tasks/runs/\{run\_id\}/input](https://api.aisa.one/apis/v1/parallel/tasks/runs/\{run\_id\}/input) * **run\_id:** path; required * **Runtime facts:** 5d413ff65ac53e696e28c5a12c4dbbb99e94b7667cbafba2e2c6b9da9156a731 [Complete OpenAPI definition](https://aisa.one/docs/openapi/parallel.ai.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "any_parallel_ai_apis_v1_parallel_tasks_runs_run_id_input", "method": "GET", "path": "/apis/v1/parallel/tasks/runs/{run_id}/input", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "explicit_zero", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.012 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.012 * **Cost contract:** explicit\_zero * **Settlement evidence source:** request\_snapshot ## 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-catalogs: parallel.ai: description: '' title: Parallel.ai x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 5d413ff65ac53e696e28c5a12c4dbbb99e94b7667cbafba2e2c6b9da9156a731 generator_version: '3' 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-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: composer_version: '20' document_hash: sha256:faf7bdc612cf28356fbb13a4aafcba6664c0f5f6176fe3ef56b5c4d887f62c03 facts_hash: 5d413ff65ac53e696e28c5a12c4dbbb99e94b7667cbafba2e2c6b9da9156a731 generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: parallel.ai 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. Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ. operationId: any_parallel_ai_apis_v1_parallel_tasks_runs_run_id_input parameters: - in: path name: run_id required: true schema: title: Run Id type: string responses: '200': content: application/json: example: input: country: France year: 2023 metadata: my_key: my_value processor: core task_spec: input_schema: json_schema: additionalProperties: false properties: country: type: string year: type: integer required: - country - year type: object type: json 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 schema: $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunInput' description: Successful Response default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseB67C75A8Feba_TaskRunInput: description: Request to run a task. properties: advanced_settings: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskAdvancedSettings' - type: 'null' description: Advanced search configuration for the task run. enable_events: anyOf: - type: boolean - type: 'null' 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). title: Enable Events input: anyOf: - type: string - additionalProperties: true type: object description: Input to the task, either text or a JSON object. examples: - What was the GDP of France in 2023? - '{"country": "France", "year": 2023}' title: Input mcp_servers: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_McpServer' type: array - type: 'null' description: Optional list of MCP servers to use for the run. title: Mcp Servers memory_scope_key: anyOf: - maxLength: 128 minLength: 1 pattern: ^[a-zA-Z0-9_-]+$ type: string - type: 'null' description: >- User-provided key identifying the memory scope to use. Omit to use personal memory, if available. title: Memory Scope Key metadata: anyOf: - additionalProperties: anyOf: - type: string - type: integer - type: number - type: boolean type: object - type: 'null' description: >- User-provided metadata stored with the run. Keys and values must be strings with a maximum length of 16 and 512 characters respectively. title: Metadata previous_interaction_id: anyOf: - type: string - type: 'null' description: Interaction ID to use as context for this request. title: Previous Interaction Id processor: description: Processor to use for the task. examples: - base title: Processor type: string 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. task_spec: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskSpec' - type: 'null' description: Task specification. If unspecified, defaults to auto output schema. 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. required: - processor - input title: TaskRunInput type: object ResponseB67C75A8Feba_TaskAdvancedSettings: description: Advanced search configuration for a task run. properties: 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. location: anyOf: - type: string - type: 'null' description: ISO 3166-1 alpha-2 country code for geo-targeted search results. examples: - us - gb - de - jp title: Location title: TaskAdvancedSettings type: object ResponseB67C75A8Feba_McpServer: description: MCP server configuration. properties: allowed_tools: anyOf: - items: type: string type: array - type: 'null' description: List of allowed tools for the MCP server. title: Allowed Tools headers: anyOf: - additionalProperties: format: password type: string writeOnly: true type: object - type: 'null' description: Headers for the MCP server. title: Headers name: description: Name of the MCP server. title: Name type: string type: const: url default: url description: Type of MCP server being configured. Always `url`. title: Type type: string url: description: URL of the MCP server. title: Url type: string required: - url - name title: McpServer type: object ResponseB67C75A8Feba_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. properties: after_date: anyOf: - format: date type: string - type: 'null' 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' title: After Date 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 items: type: string title: Exclude Domains type: array 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 items: type: string title: Include Domains type: array title: SourcePolicy type: object ResponseB67C75A8Feba_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. properties: input_schema: anyOf: - type: string - $ref: '#/components/schemas/ResponseB67C75A8Feba_JsonSchema' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TextSchema' - type: 'null' 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. title: Input Schema output_schema: anyOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_JsonSchema' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TextSchema' - $ref: '#/components/schemas/ResponseB67C75A8Feba_AutoSchema' - type: string 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. title: Output Schema required: - output_schema title: TaskSpec type: object ResponseB67C75A8Feba_Webhook: description: Webhooks for Task Runs. properties: event_types: default: [] description: Event types to send the webhook notifications for. items: enum: - task_run.status type: string title: Event Types type: array url: description: URL for the webhook. title: Url type: string required: - url title: Webhook type: object ResponseB67C75A8Feba_TaskDataSources: additionalProperties: false properties: 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. items: type: string title: Free type: array 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. items: type: string title: Pay Per Use type: array title: TaskDataSources type: object ResponseB67C75A8Feba_JsonSchema: description: JSON schema for a task input or output. properties: json_schema: additionalProperties: true 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 title: Json Schema type: object type: const: json default: json description: The type of schema being defined. Always `json`. title: Type type: string required: - json_schema title: JsonSchema type: object ResponseB67C75A8Feba_TextSchema: description: Text description for a task input or output. properties: description: anyOf: - type: string - type: 'null' description: A text description of the desired output from the task. examples: - GDP in USD for the year, formatted like '$3.1 trillion (2023)' title: Description type: const: text default: text description: The type of schema being defined. Always `text`. title: Type type: string title: TextSchema type: object ResponseB67C75A8Feba_AutoSchema: description: Auto schema for a task input or output. properties: type: const: auto default: auto description: The type of schema being defined. Always `auto`. title: Type type: string title: AutoSchema type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.