← All Toolkits

Multi Execute Tool

COMPOSIO_MULTI_EXECUTE_TOOLExternalDestructiveImportant

Executes up to 50 tools in parallel and returns structured outputs ready for immediate analysis.

When to use it

Use `COMPOSIO_MULTI_EXECUTE_TOOL` to run tools that `COMPOSIO_SEARCH_TOOLS` discovered. Batch tools into one call only when they are logically independent, with no ordering or output-to-input dependencies between them.

Pass strictly schema-compliant arguments and make sure each toolkit has an active connection first. Set `sync_response_to_workbench` to true when a response may be large or needed for later scripting; otherwise process small responses inline.

Input parameters

toolsarrayRequired

List of logically independent tools to execute in parallel.

thoughtstring

One-sentence, concise, high-level rationale (no step-by-step).

sync_response_to_workbenchbooleanRequired

Predictively set true when the response may be large or needed for later scripting. Saves the full response to the workbench while returning an inline preview. If the result is small, keep it inline. Default false.

current_stepstring

Short enum for current step of the workflow execution. Eg FETCHING_EMAILS, GENERATING_REPLIES. Always include to keep execution aligned with the workflow.

current_step_metricstring

Progress metrics for the current step - use to track how far execution has advanced. Format as a string "done/total units" - example "10/100 emails", "0/n messages", "3/10 pages".

session_idstring

Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.

Response

dataobject

Data from the action execution

errorstring

Error if any occurred during the execution of the action

successfulboolean

Whether or not the action execution was successful or not