Parallel
Run async web research jobs.
DataAPI key32 endpoints
Runtime credentials
Connecting Parallel via OAuth or your own API key requires the following secret slots in your workspace:
- PARALLEL_API_KEY
Endpoints
| Operation | Method & path | Effect | Latency | Rate | Cost |
|---|---|---|---|---|---|
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. | POST /composio/parallel/parallel_add_enrichment_to_find_all_run | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_add_runs_to_task_group | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_cancel_find_all_run | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_create_chat_completions | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_create_monitor | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_create_task_group | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_create_task_run | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_delete_monitor | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_extend_find_all_run | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_extract | external_send | — | — | managed |
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. | GET /composio/parallel/parallel_fetch_task_group_runs | none | — | — | managed |
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. | GET /composio/parallel/parallel_find_all | none | — | — | managed |
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. | GET /composio/parallel/parallel_get_find_all_run_result | none | — | — | managed |
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. | GET /composio/parallel/parallel_get_find_all_run_schema | none | — | — | managed |
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. | POST /composio/parallel/parallel_ingest_find_all_run | external_send | — | — | managed |
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. | GET /composio/parallel/parallel_list_monitor_events | none | — | — | managed |
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. | GET /composio/parallel/parallel_list_monitors | none | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_event_group | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_find_all_run_status | external_send | — | — | managed |
PARALLEL_RETRIEVE_MONITOR Tool to retrieve a specific monitor by ID. Returns the monitor configuration including status, cadence, query, and webhook settings. | POST /composio/parallel/parallel_retrieve_monitor | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_task_group | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_task_group_run | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_task_run | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_task_run_input | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_retrieve_task_run_result | external_send | — | — | managed |
PARALLEL_SEARCH Tool to perform parallel semantic search. Use when you need to retrieve top matching documents for multiple queries in a single call. | POST /composio/parallel/parallel_search | external_send | — | — | managed |
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). | POST /composio/parallel/parallel_simulate_event | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_stream_find_all_events | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_stream_task_group_events | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_stream_task_run_events | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_suggest_task | external_send | — | — | managed |
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. | POST /composio/parallel/parallel_update_monitor | external_send | — | — | managed |