> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi Execute Tool

> Fast and parallel tool executor for tools discovered through COMPOSIO_SEARCH_TOOLS

**Slug:** `COMPOSIO_MULTI_EXECUTE_TOOL`

**Tags:** openWorldHint, destructiveHint, important

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.

> [!NOTE]
>
> 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

**tools** `array\<object\>` *required*

List of logically independent tools to execute in parallel.

**properties**

**tool\_slug** `string` *required*

The slug of the tool to execute — must be a valid tool slug; never invent.

**arguments** `object` *required*

The arguments to pass to the tool. Use exact field names and types; do not diverge from the tool's argument schema.

**thought** `string`

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

**sync\_response\_to\_workbench** `boolean` *required*

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\_step** `string`

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\_metric** `string`

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\_id** `string`

Pass the session\_id if you received one from a prior COMPOSIO\_SEARCH\_TOOLS call.

## Response

**data** `object`

Data from the action execution

**properties**

**error\_count** `integer`

Number of failed tool executions

**results** `array\<object\>`

List of responses from executing the tools. Order matches the input order.

**properties**

**error** `string`

Error message if the tool execution failed

**index** `integer`

Original index of the tool in the request

**response** `object`

The response from executing the tool if successful

**tool\_slug** `string`

The slug of the tool that was executed

**success\_count** `integer`

Number of successful tool executions

**total\_count** `integer`

Total number of tools executed

**session** `object`

Session info echoed back to reinforce reuse: \{ id: string, instructions: string }

**properties**

**id** `string`

**instructions** `string`

**remote\_file\_info** `object`

Information about the complete response saved to a remote file when response is too large or when sync\_response\_to\_workbench is true

**next\_steps** `string`

Next steps for the caller

**error** `string`

Error if any occurred during the execution of the action

**successful** `boolean`

Whether or not the action execution was successful or not
