Sign in
Tools

Execute Tool Inline

Execute a fully inline tool config (not yet persisted) against the supplied argument values and return its output.

Runtime failures (bad args, thrown exceptions, timeouts) are returned as HTTP 200 with success=False and a clean error message rather than a 500, so callers can render them inline.

Note: inline-Python tools run their code via exec server-side and are not sandboxed. This endpoint is intended for authoring/debugging within a team's own workspace.

post/workflows/v1/tools/execute

Request body

argsobject

Argument values to invoke the tool with, keyed by the tool's parameter names.

Response

Successful Response

successboolean required
{"stackTrail":"components:schemas:ToolExecuteResponse:properties:result:anyOf","oasType":"schema","type":"unknown","title":"Result","description":"The tool's return value on success.","nullable":true}
errorstring nullable

Clean error message when success is False.

latency_msinteger nullable

Wall-clock execution time in milliseconds.

Changes