v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB
agent builder

Run a tool

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/agent_builder/tools/_execute</span></div>

Refer to Spaces for more information.

Run a tool with parameters. Use this endpoint to run a tool directly with specified inputs and optional external connector integration. To learn more about Agent Builder tools, refer to the tools documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:read.

post/api/agent_builder/tools/_execute

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

connector_idstring

Optional connector ID for tools that require external integrations.

tool_idstring required

The ID of the tool to execute.

tool_paramsobject required

Parameters to pass to the tool execution. See examples for details

Response

Indicates a successful response