# Parallel

Parallel offers a Task API for automated, structured web research, transforming natural language queries into precise, schema-compliant outputs.

- **Category:** ai web scraping
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 32
- **Triggers:** 0
- **Slug:** `PARALLEL`
- **Version:** 20260309_00

## Tools

### Add Enrichment to FindAll Run

**Slug:** `PARALLEL_ADD_ENRICHMENT_TO_FIND_ALL_RUN`

Tool to add an enrichment to a FindAll run. Use when you need to enrich existing FindAll run results with additional structured data fields. Enrichments define what information to extract from matched entities using a JSON schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `processor` | string | No | Processor to use for the enrichment task. Defaults to 'core'. |
| `findall_id` | string | Yes | ID of the FindAll run to add enrichment to. |
| `mcp_servers` | array | No | Optional list of MCP servers to use for the enrichment task. |
| `output_schema` | object | Yes | JSON schema defining the structure and fields for the enrichment output. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Runs to Task Group

**Slug:** `PARALLEL_ADD_RUNS_TO_TASK_GROUP`

Tool to initiate multiple task runs within a TaskGroup. Use when you need to execute multiple tasks in parallel within an existing task group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `inputs` | array | Yes | List of task runs to execute. Up to 1,000 runs can be specified per request. |
| `taskgroup_id` | string | Yes | Unique identifier of the task group to add runs to. |
| `default_task_spec` | object | No | Task specification for defining input and output schemas. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel FindAll Run

**Slug:** `PARALLEL_CANCEL_FIND_ALL_RUN`

Tool to cancel an active FindAll run by findall_id. Use when you need to stop a running FindAll operation before it completes. Cannot cancel runs that have already terminated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `findall_id` | string | Yes | ID of the FindAll run to cancel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Chat Completions

**Slug:** `PARALLEL_CREATE_CHAT_COMPLETIONS`

Tool to get realtime chat completions from Parallel AI. Use when you need conversational AI responses or structured outputs via chat interface. Can be combined with Task API processors for research-grade structured outputs with citations and reasoning.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | The number of chat completions to generate. Note: This parameter is currently unsupported by the API. |
| `model` | string | Yes | The model to use for chat completions. Available models: 'speed' (low latency), 'lite', 'base', 'core' (research-grade outputs). |
| `top_p` | number | No | The top p to use for chat completions. Note: This parameter is currently unsupported by the API. |
| `stream` | boolean | No | Whether to stream the chat completions. When true, returns a stream of partial responses. |
| `messages` | array | Yes | The messages to use for chat completions. Must contain at least one message. |
| `max_tokens` | integer | No | The maximum number of tokens to generate. Note: This parameter is currently unsupported by the API. |
| `temperature` | number | No | The temperature to use for chat completions. Note: This parameter is currently unsupported by the API. |
| `response_format` | object | No | Response format configuration for chat completions. |
| `presence_penalty` | number | No | The presence penalty to use for chat completions. Note: This parameter is currently unsupported by the API. |
| `frequency_penalty` | number | No | The frequency penalty to use for chat completions. Note: This parameter is currently unsupported by the API. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Monitor

**Slug:** `PARALLEL_CREATE_MONITOR`

Tool to create a web monitor that periodically runs the specified query. The monitor runs once at creation and then continues according to the specified cadence (hourly, daily, weekly, or every two weeks). Use when you need to track changes or developments for a specific search query over time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Search query to monitor for material changes. |
| `cadence` | string ("daily" | "weekly" | "hourly" | "every_two_weeks") | Yes | Frequency at which the monitor runs: hourly, daily, weekly, or every_two_weeks. |
| `webhook` | object | No | Webhook configuration for monitor notifications. |
| `metadata` | object | No | User-provided metadata stored with the monitor. This field is returned in webhook notifications and GET requests, enabling you to map responses to corresponding objects in your application. For example, if you are building a Slackbot that monitors changes, you could store the Slack thread ID here to properly route webhook responses back to the correct conversation thread. |
| `output_schema` | object | No | Output schema configuration for monitor events. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Task Group

**Slug:** `PARALLEL_CREATE_TASK_GROUP`

Tool to create a new task group. Use when batching multiple tasks for parallel execution. Task Groups enable grouping and tracking of multiple task runs within a single manageable unit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `metadata` | object | No | User-provided metadata stored with the task group. Keys are strings, values can be string, integer, number, or boolean. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Task Run

**Slug:** `PARALLEL_CREATE_TASK_RUN`

Tool to create and initiate a task run. Returns immediately with a run object in status 'queued'. Use when you need to execute tasks asynchronously with Parallel AI processors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Input to the task, either text or a JSON object. |
| `webhook` | object | No | Webhook configuration for task run completion events. |
| `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. |
| `processor` | string | Yes | Processor to use for the task (e.g., 'lite', 'base', 'core', 'pro'). |
| `task_spec` | object | No | Task specification defining input and output schemas. |
| `mcp_servers` | array | No | Optional list of MCP servers to use for the run. To enable this feature, specify 'mcp-server-2025-07-17' in the 'parallel-beta' header. |
| `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. 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, specify 'events-sse-2025-07-24' in the 'parallel-beta' header. |
| `parallel_beta` | string | No | Beta features to enable. Comma-separated list of beta feature flags (e.g., 'webhook-2025-08-12,events-sse-2025-07-24'). This will be sent as a header. |
| `source_policy` | object | No | Source policy governing preferred and disallowed domains in web search results. |
| `previous_interaction_id` | string | No | Interaction ID to use as context for this request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Monitor

**Slug:** `PARALLEL_DELETE_MONITOR`

Tool to delete a monitor, stopping all future executions. Use when you need to permanently remove a monitor. Deleted monitors can no longer be updated or retrieved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `monitor_id` | string | Yes | Unique identifier of the monitor to delete. Deleted monitors can no longer be updated or retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Extend FindAll Run

**Slug:** `PARALLEL_EXTEND_FIND_ALL_RUN`

Tool to extend a FindAll run by adding additional matches to the current match limit. Use when you need to increase the number of matches for an existing FindAll run that is still active or has completed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `findall_id` | string | Yes | ID of the FindAll run to extend. |
| `additional_match_limit` | integer | Yes | Additional number of matches to find for this FindAll run. This value will be added to the current match limit to determine the new total match limit. Must be greater than 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Extract Content from URLs

**Slug:** `PARALLEL_EXTRACT`

Tool to extract relevant content from specific web URLs. Use when you need to fetch and extract content from known URLs with optional focusing on specific objectives or search queries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `urls` | array | Yes | List of URLs to extract content from |
| `excerpts` | string | No | Include excerpts from each URL relevant to the search objective and queries. Can be a boolean or settings object. Note that if neither objective nor search_queries is provided, excerpts are redundant with full content. |
| `objective` | string | No | If provided, focuses extracted content on the specified search objective |
| `fetch_policy` | object | No | Fetch policy configuration for cache and timeout settings. |
| `full_content` | string | No | Include full content from each URL. Can be a boolean or settings object. Note that if neither objective nor search_queries is provided, excerpts are redundant with full content. |
| `search_queries` | array | No | If provided, focuses extracted content on the specified keyword search queries |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Fetch Task Group Runs

**Slug:** `PARALLEL_FETCH_TASK_GROUP_RUNS`

Tool to retrieve task runs from a Task Group as a resumable stream. Use when you need to fetch all runs within a group, optionally including their inputs and outputs. The stream can be resumed using the event_id as a cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string | No | Filter runs by status (e.g., queued, running, completed, failed, cancelled). |
| `taskgroup_id` | string | Yes | Unique identifier of the Task Group to fetch runs from. |
| `include_input` | boolean | No | Whether to include task run inputs in the response. Default is False. |
| `last_event_id` | string | No | ID of the last received event to resume streaming from. Used as cursor for pagination. |
| `include_output` | boolean | No | Whether to include task run outputs in the response. Default is False. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start FindAll Run

**Slug:** `PARALLEL_FIND_ALL`

Tool to start a FindAll run. Use when you need to discover and match entities based on natural-language objectives. Supports custom conditions, exclusion lists, and webhook callbacks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook` | object | No | Optional webhook configuration for run events. |
| `metadata` | object | No | Optional user metadata to store with the run. Values must be primitive types (string, int, float, or bool). |
| `generator` | string ("base" | "core" | "pro" | "preview") | Yes | Quality/cost tier for the run. |
| `objective` | string | Yes | Natural-language objective for the FindAll run. |
| `entity_type` | string | Yes | Type of entity to find (e.g., companies, people). |
| `match_limit` | integer | Yes | Maximum number of matches to return (between 5 and 1000 inclusive). |
| `exclude_list` | array | No | Optional list of entities to exclude from matching. |
| `match_conditions` | array | Yes | List of conditions that a candidate must satisfy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FindAll Run Result

**Slug:** `PARALLEL_GET_FIND_ALL_RUN_RESULT`

Tool to fetch the final (or latest available) FindAll candidates and result payload for a run. Use when you need to retrieve matched/unmatched candidates after a FindAll run has progressed or completed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `findall_id` | string | Yes | The identifier for the FindAll run. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get FindAll Run Schema

**Slug:** `PARALLEL_GET_FIND_ALL_RUN_SCHEMA`

Tool to retrieve the schema configuration of a FindAll run by findall_id. Use when you need to inspect the objective, entity type, match conditions, and other schema details for a previously created FindAll run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `findall_id` | string | Yes | The identifier for the FindAll run. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ingest FindAll Run

**Slug:** `PARALLEL_INGEST_FIND_ALL_RUN`

Tool to transform a natural language search objective into a structured FindAll specification. Use when you need to generate a FindAll run spec from a user's natural language description. The generated specification serves as a suggested starting point and can be further customized.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `objective` | string | Yes | Natural language search objective to transform into a structured FindAll specification. Describe what you want to find (e.g., 'Find technology companies in San Francisco with over 100 employees'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Monitor Events

**Slug:** `PARALLEL_LIST_MONITOR_EVENTS`

Tool to list events for a monitor from up to the last 300 event groups. Retrieves events including errors and material changes in reverse chronological order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `monitor_id` | string | Yes | Unique identifier of the monitor to retrieve events for. |
| `lookback_period` | string | No | Lookback period to fetch events from. Sample values: `10d`, `1w`. A minimum of 1 day is supported and with one day increments. Use `d` for days, `w` for weeks. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Monitors

**Slug:** `PARALLEL_LIST_MONITORS`

Tool to list active monitors for the user. Returns all monitors regardless of status with their configuration and current state. Supports cursor-based pagination using monitor_id and limit parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | string | No | Maximum number of monitors to return. If not specified, returns all monitors. |
| `monitor_id` | string | No | Monitor ID to start listing after (cursor for pagination). Returns monitors starting with this ID in lexicographic order. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Event Group

**Slug:** `PARALLEL_RETRIEVE_EVENT_GROUP`

Tool to retrieve an event group for a monitor. Use when you have a valid monitor ID and event group ID and want to view the execution history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `monitor_id` | string | Yes | Unique identifier of the monitor. |
| `event_group_id` | string | Yes | Unique identifier of the event group to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve FindAll Run Status

**Slug:** `PARALLEL_RETRIEVE_FIND_ALL_RUN_STATUS`

Tool to retrieve status and metadata for a FindAll run by findall_id. Use when you need to poll or check the progress of a FindAll run that was previously created.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `findall_id` | string | Yes | ID of the FindAll run to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Monitor

**Slug:** `PARALLEL_RETRIEVE_MONITOR`

Tool to retrieve a specific monitor by ID. Returns the monitor configuration including status, cadence, query, and webhook settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `monitor_id` | string | Yes | Unique identifier of the monitor to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Task Group

**Slug:** `PARALLEL_RETRIEVE_TASK_GROUP`

Tool to retrieve details of a specific task group. Use when you have a valid task group ID and want to view its details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `taskgroup_id` | string | Yes | Unique identifier of the task group to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Task Group Run

**Slug:** `PARALLEL_RETRIEVE_TASK_GROUP_RUN`

Tool to retrieve run status by run_id for a task group. Use when you need to check the status of a specific task group run or poll for completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | Yes | Unique identifier of the run to retrieve. |
| `taskgroup_id` | string | Yes | Unique identifier of the task group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Task Run

**Slug:** `PARALLEL_RETRIEVE_TASK_RUN`

Tool to retrieve run status by run_id. Use when you need to check the status or details of a specific task run. The run result is available from the /result endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | Yes | ID of the task run to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Task Run Input

**Slug:** `PARALLEL_RETRIEVE_TASK_RUN_INPUT`

Tool to retrieve the input data of a specific task run by run_id. Use when you need to view the original input parameters that were provided to a task run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | Yes | Unique identifier of the task run to retrieve input for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Task Run Result

**Slug:** `PARALLEL_RETRIEVE_TASK_RUN_RESULT`

Tool to retrieve the result of a task run by run_id, blocking until the run completes. Use when you need to wait for and fetch the final output of a previously initiated task run. The request will block until the run completes or the timeout is reached.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | Yes | The identifier of the task run to retrieve results for. |
| `timeout` | integer | No | Timeout in seconds for blocking request. If not provided, defaults to 600 seconds (10 minutes). The request will block until the run completes or the timeout is reached. |
| `parallel_beta` | string | No | Optional beta version header for accessing beta features. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Parallel Search

**Slug:** `PARALLEL_SEARCH`

Tool to perform parallel semantic search. Use when you need to retrieve top matching documents for multiple queries in a single call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search_queries` | array | Yes | List of search query texts to run in parallel Must be non-empty; all entries must be strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Simulate Event

**Slug:** `PARALLEL_SIMULATE_EVENT`

Tool to simulate sending an event for a monitor. Use when testing monitor webhooks or validating monitor configurations. Simulates sending an event of the specified type (defaults to monitor.event.detected).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event_type` | string ("monitor.event.detected" | "monitor.execution.completed" | "monitor.execution.failed") | No | Event types that can be simulated for a monitor. |
| `monitor_id` | string | Yes | Unique identifier of the monitor to simulate an event for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stream FindAll Events

**Slug:** `PARALLEL_STREAM_FIND_ALL_EVENTS`

Tool to stream events from a FindAll run. Use when you need real-time updates on candidate discovery, matching progress, and run status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `timeout` | integer | No | Duration in seconds to keep the connection open if no new events occur. |
| `findall_id` | string | Yes | Unique identifier of the FindAll run to stream events from. |
| `last_event_id` | string | No | ID of the last received event to resume streaming from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stream Task Group Events

**Slug:** `PARALLEL_STREAM_TASK_GROUP_EVENTS`

Tool to stream events for a Task Group. Use when you want real-time updates of group status and run completions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `timeout` | integer | No | Duration in seconds to keep the connection open if no new events occur. |
| `taskgroup_id` | string | Yes | Unique identifier of the Task Group to stream events from. |
| `last_event_id` | string | No | ID of the last received event to resume streaming from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stream Task Run Events

**Slug:** `PARALLEL_STREAM_TASK_RUN_EVENTS`

Tool to stream events for a Task Run. Returns progress updates and state changes for the task run. For runs without enable_events=true, event frequency is reduced.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | Yes | Unique identifier of the Task Run to stream events from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Suggest Task

**Slug:** `PARALLEL_SUGGEST_TASK`

Tool to suggest tasks based on user intent. Use when you need task specifications generated from a natural language description of what you want to accomplish.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_intent` | string | Yes | User intent to guide the suggestion (e.g., 'Build authentication system for web app') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Monitor

**Slug:** `PARALLEL_UPDATE_MONITOR`

Tool to update a monitor's configuration. Use when you need to modify an existing monitor's cadence, query, metadata, or webhook settings. At least one field must be non-null to apply an update.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Updated search query for the monitor. Use this for minor updates to prompts and instructions only. Major changes to the query may lead to unexpected results in change detection, as the monitor compares new results with what was previously seen. |
| `cadence` | string ("daily" | "weekly" | "hourly" | "every_two_weeks") | No | Monitor cadence options. |
| `webhook` | object | No | Webhook configuration for monitor updates. |
| `metadata` | object | No | Updated user-provided metadata. This field is returned in webhook notifications, enabling you to map responses to corresponding objects in your application. |
| `monitor_id` | string | Yes | Unique identifier of the monitor to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
