Call a tool

POST 
/api/v1/tools/:tool_id/call

Directly invokes a tool and returns its output. Supported for http, soat, and mcp tools. client tools cannot be invoked server-side and will return 422. For soat and mcp tools the action field is required and identifies which action (SOAT) or tool name (MCP) to invoke. For http tools action is ignored. preset_parameters stored on the tool are merged with the caller-supplied input before execution; preset keys take lower precedence.

Request

Responses

200

Tool output

400

Bad Request — invalid input or unknown action

401

Unauthorized

403

Forbidden

404

Tool not found

422

Unprocessable — tool type cannot be invoked server-side