> ## 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

# Stream Task Group Events

> Streams events from a TaskGroup: status updates and run completions.The connection will remain open for up to an hour as long as at least one run in the group is still active.

<!-- aisa-pricing:start -->
Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Request contract

* **Method and path:** GET /apis/v1/parallel/tasks/groups/\{taskgroup\_id}/events
* **Availability:** enabled
* **Request URL template:** [https://api.aisa.one/apis/v1/parallel/tasks/groups/\&#123;taskgroup\&#95;id\&#125;/events](https://api.aisa.one/apis/v1/parallel/tasks/groups/\&#123;taskgroup\&#95;id\&#125;/events)
* **taskgroup\_id:** path; required
* **last\_event\_id:** query; optional
* **timeout:** query; optional
* **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_groups_tas_731766",
  "method": "GET",
  "path": "/apis/v1/parallel/tasks/groups/{taskgroup_id}/events",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "in": "path",
      "name": "taskgroup_id",
      "required": true,
      "schema": {
        "title": "Taskgroup Id",
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "last_event_id",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Last Event Id"
      }
    },
    {
      "in": "query",
      "name": "timeout",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Timeout"
      }
    }
  ],
  "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/groups/{taskgroup_id}/events
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/groups/{taskgroup_id}/events:
    get:
      tags:
        - default
      summary: Stream Task Group Events
      description: >-
        Streams events from a TaskGroup: status updates and run completions.The
        connection will remain open for up to an hour as long as at least one
        run in the group is still active.


        <!-- aisa-pricing:start -->

        Published reference price: $0.012 USD per successful request.
        Account-specific pricing and final settlement may differ.

        <!-- aisa-pricing:end -->
      operationId: any_parallel_ai_apis_v1_parallel_tasks_groups_tas_731766
      parameters:
        - in: path
          name: taskgroup_id
          required: true
          schema:
            title: Taskgroup Id
            type: string
        - in: query
          name: last_event_id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Last Event Id
        - in: query
          name: timeout
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            title: Timeout
      responses:
        '200':
          content:
            text/event-stream:
              example:
                event_id: '123'
                status:
                  is_active: false
                  modified_at: '2025-04-23T20:21:48.037943Z'
                  num_task_runs: 1
                  status_message: ''
                  task_run_status_counts:
                    completed: 1
                type: task_group_status
              schema:
                discriminator:
                  mapping:
                    error: '#/components/schemas/ResponseB67C75A8Feba_ErrorEvent'
                    task_group_status: >-
                      #/components/schemas/ResponseB67C75A8Feba_TaskGroupStatusEvent
                    task_run.state: '#/components/schemas/ResponseB67C75A8Feba_TaskRunEvent'
                  propertyName: type
                oneOf:
                  - $ref: >-
                      #/components/schemas/ResponseB67C75A8Feba_TaskGroupStatusEvent
                  - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunEvent'
                  - $ref: '#/components/schemas/ResponseB67C75A8Feba_ErrorEvent'
                title: >-
                  Response 200 Tasks Sessions Events Get V1 Tasks Groups 
                  Taskgroup Id  Events Get
          description: Successful Response
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    ResponseB67C75A8Feba_ErrorEvent:
      description: Event indicating an error.
      properties:
        error:
          $ref: '#/components/schemas/ResponseB67C75A8Feba_Error'
          description: Error.
        type:
          const: error
          description: Event type; always 'error'.
          title: Type
          type: string
      required:
        - type
        - error
      title: ErrorEvent
      type: object
    ResponseB67C75A8Feba_TaskGroupStatusEvent:
      description: Event indicating an update to group status.
      properties:
        event_id:
          description: Cursor to resume the event stream.
          title: Event ID
          type: string
        status:
          $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskGroupStatus'
          description: Task group status object.
        type:
          const: task_group_status
          description: Event type; always 'task_group_status'.
          title: Type
          type: string
      required:
        - type
        - event_id
        - status
      title: TaskGroupStatusEvent
      type: object
    ResponseB67C75A8Feba_TaskRunEvent:
      description: |-
        Event when a task run transitions to a non-active status.

        May indicate completion, cancellation, or failure.
      properties:
        event_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Cursor to resume the event stream. Always empty for non Task Group
            runs.
          title: Event ID
        input:
          anyOf:
            - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunInput'
            - type: 'null'
          description: Input to the run; included only if requested.
        output:
          anyOf:
            - discriminator:
                mapping:
                  json: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput'
                  text: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput'
                propertyName: type
              oneOf:
                - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput'
                - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput'
            - type: 'null'
          description: >-
            Output from the run; included only if requested and if status ==
            `completed`.
          title: Output
        run:
          $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRun'
          description: Task run object.
        type:
          const: task_run.state
          description: Event type; always 'task_run.state'.
          title: Type
          type: string
      required:
        - type
        - event_id
        - run
      title: TaskRunEvent
      type: object
    ResponseB67C75A8Feba_Error:
      description: An error message.
      properties:
        detail:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Optional detail supporting the error.
          title: Detail
        message:
          description: Human-readable message.
          title: Message
          type: string
        ref_id:
          description: Reference ID for the error.
          title: Reference ID
          type: string
      required:
        - ref_id
        - message
      title: Error
      type: object
    ResponseB67C75A8Feba_TaskGroupStatus:
      description: Status of a task group.
      properties:
        is_active:
          description: >-
            True if at least one run in the group is currently active, i.e.
            status is one of {'cancelling', 'queued', 'running'}.
          title: Is Active
          type: boolean
        modified_at:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Timestamp of the last status update to the group, as an RFC 3339
            string.
          examples:
            - '2025-04-24T18:56:22.513132Z'
          title: Modified At
        num_task_runs:
          description: Number of task runs in the group.
          title: Num Task Runs
          type: integer
        status_message:
          anyOf:
            - type: string
            - type: 'null'
          description: Human-readable status message for the group.
          title: Status Message
        task_run_status_counts:
          additionalProperties:
            type: integer
          description: Number of task runs with each status.
          propertyNames:
            enum:
              - queued
              - action_required
              - running
              - completed
              - failed
              - cancelling
              - cancelled
          title: Task Run Status Counts
          type: object
      required:
        - num_task_runs
        - task_run_status_counts
        - is_active
        - status_message
        - modified_at
      title: TaskGroupStatus
      type: object
    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_TaskRunJsonOutput:
      description: Output from a task that returns JSON.
      properties:
        basis:
          description: >-
            Basis for each top-level field in the JSON output. List fields also
            include per-element entries with dot-delimited indexes, such as
            `key_executives.0`.
          items:
            $ref: '#/components/schemas/ResponseB67C75A8Feba_FieldBasis'
          title: Basis
          type: array
        beta_fields:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          deprecated: true
          description: >-
            Deprecated. mcp-server-2025-07-17 is now included directly in the
            output (e.g. mcp_tool_calls).
          title: Beta Fields
        content:
          additionalProperties: true
          description: >-
            Output from the task as a native JSON object, as determined by the
            output schema of the task spec.
          title: Content
          type: object
        mcp_tool_calls:
          anyOf:
            - items:
                $ref: '#/components/schemas/ResponseB67C75A8Feba_McpToolCall'
              type: array
            - type: 'null'
          description: MCP tool calls made by the task.
          title: Mcp Tool Calls
        output_schema:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            Output schema for the Task Run. Populated only if the task was
            executed with an auto schema.
          title: Output Schema
        type:
          const: json
          description: >-
            The type of output being returned, as determined by the output
            schema of the task spec.
          title: Type
          type: string
      required:
        - basis
        - type
        - content
      title: TaskRunJsonOutput
      type: object
    ResponseB67C75A8Feba_TaskRunTextOutput:
      description: Output from a task that returns text.
      properties:
        basis:
          description: Basis for the output. The basis has a single field 'output'.
          items:
            $ref: '#/components/schemas/ResponseB67C75A8Feba_FieldBasis'
          title: Basis
          type: array
        beta_fields:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          deprecated: true
          description: >-
            Deprecated. mcp-server-2025-07-17 is now included directly in the
            output (e.g. mcp_tool_calls).
          title: Beta Fields
        content:
          description: Text output from the task.
          title: Content
          type: string
        mcp_tool_calls:
          anyOf:
            - items:
                $ref: '#/components/schemas/ResponseB67C75A8Feba_McpToolCall'
              type: array
            - type: 'null'
          description: MCP tool calls made by the task.
          title: Mcp Tool Calls
        type:
          const: text
          description: >-
            The type of output being returned, as determined by the output
            schema of the task spec.
          title: Type
          type: string
      required:
        - basis
        - type
        - content
      title: TaskRunTextOutput
      type: object
    ResponseB67C75A8Feba_TaskRun:
      description: Status of a task run.
      properties:
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          description: Timestamp of the creation of the task, as an RFC 3339 string.
          examples:
            - '2025-04-24T18:56:22.513132Z'
          title: Created At
        error:
          anyOf:
            - $ref: '#/components/schemas/ResponseB67C75A8Feba_Error'
            - type: 'null'
          description: Error for the run, present only if status is 'failed'.
        interaction_id:
          description: >-
            Identifier for this interaction. Pass this value as
            `previous_interaction_id` to reuse context for a future request.
          examples:
            - trun_e0083b6aac0544eb8686e8d2a76533d2
          title: Interaction ID
          type: string
        is_active:
          description: >-
            Whether the run is currently active, i.e. status is one of
            {'cancelling', 'queued', 'running'}.
          title: Is Active
          type: boolean
        metadata:
          anyOf:
            - additionalProperties:
                anyOf:
                  - type: string
                  - type: integer
                  - type: number
                  - type: boolean
              type: object
            - type: 'null'
          description: User-provided metadata stored with the run.
          examples:
            - {}
          title: Metadata
        modified_at:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Timestamp of the last modification to the task, as an RFC 3339
            string.
          examples:
            - '2025-04-24T18:56:22.513132Z'
          title: Modified At
        processor:
          description: Processor used for the run.
          examples:
            - base
          title: Processor
          type: string
        run_id:
          description: ID of the task run.
          examples:
            - trun_e0083b6aac0544eb8686e8d2a76533d2
          title: Run ID
          type: string
        status:
          description: Status of the run.
          enum:
            - queued
            - action_required
            - running
            - completed
            - failed
            - cancelling
            - cancelled
          examples:
            - queued
            - action_required
            - running
            - completed
            - failed
            - cancelling
            - cancelled
          title: Status
          type: string
        taskgroup_id:
          anyOf:
            - type: string
            - type: 'null'
          description: ID of the taskgroup to which the run belongs.
          title: Taskgroup ID
        warnings:
          anyOf:
            - items:
                $ref: '#/components/schemas/ResponseB67C75A8Feba_Warning'
              type: array
            - type: 'null'
          description: Warnings for the run, if any.
          examples:
            - []
          title: Warnings
      required:
        - run_id
        - interaction_id
        - status
        - is_active
        - processor
        - created_at
        - modified_at
      title: TaskRun
      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_FieldBasis:
      description: Citations and reasoning supporting one field of a task output.
      properties:
        citations:
          default: []
          description: List of citations supporting the output field.
          items:
            $ref: '#/components/schemas/ResponseB67C75A8Feba_Citation'
          title: Citations
          type: array
        confidence:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Confidence level for the output field. Only certain processors
            provide confidence levels.
          examples:
            - low
            - medium
            - high
          title: Confidence
        field:
          description: Name of the output field.
          title: Field
          type: string
        reasoning:
          description: Reasoning for the output field.
          title: Reasoning
          type: string
      required:
        - field
        - reasoning
      title: FieldBasis
      type: object
    ResponseB67C75A8Feba_McpToolCall:
      description: Result of an MCP tool call.
      properties:
        arguments:
          description: Arguments used to call the MCP tool.
          title: Arguments
          type: string
        content:
          anyOf:
            - type: string
            - type: 'null'
          description: Output received from the tool call, if successful.
          title: Content
        error:
          anyOf:
            - type: string
            - type: 'null'
          description: Error message if the tool call failed.
          title: Error
        server_name:
          description: Name of the MCP server.
          title: Server Name
          type: string
        tool_call_id:
          description: Identifier for the tool call.
          title: Tool Call ID
          type: string
        tool_name:
          description: Name of the tool being called.
          title: Tool Name
          type: string
      required:
        - tool_call_id
        - server_name
        - tool_name
        - arguments
      title: McpToolCall
      type: object
    ResponseB67C75A8Feba_Warning:
      description: Human-readable message for a task.
      properties:
        detail:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: Optional detail supporting the warning.
          title: Detail
        message:
          description: Human-readable message.
          title: Message
          type: string
        type:
          description: >-
            Type of warning. Note that adding new warning types is considered a
            backward-compatible change.
          enum:
            - spec_validation_warning
            - input_validation_warning
            - warning
          examples:
            - spec_validation_warning
            - input_validation_warning
          title: Type
          type: string
      required:
        - type
        - message
      title: Warning
      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
    ResponseB67C75A8Feba_Citation:
      description: A citation for a task output.
      properties:
        excerpts:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          default: null
          description: >-
            Excerpts from the citation supporting the output. Only certain
            processors provide excerpts.
          title: Excerpts
        title:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: Title of the citation.
          title: Title
        url:
          description: URL of the citation.
          title: Url
          type: string
      required:
        - url
      title: Citation
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.