v5

OpenAPI 3.1.02026-07-31129337684.6 KB

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.

dry_runboolean

When True, side-effecting tools (writes/sends/unknown) are validated but NOT executed - no external effect occurs and a simulated result is returned. Pure/read-only tools run normally.

dynamic_variablesobject

Test values for {{dynamic}} placeholders in the tool config (endpoint/headers/body/code). Resolved before execution to mirror the live workflow runtime.

runtime_variablesobject

Test values for [[runtime]] placeholders in the tool config (endpoint/headers/body/code). Resolved before execution to mirror the live workflow runtime.

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

Full human-readable error description when success is False. Always set on failure.

latency_msinteger nullable

Wall-clock execution time in milliseconds.

dry_runboolean

Whether this run was a validate-only dry run.

side_effectstring nullable

The tool's side-effect classification (none/reads/writes/sends/unknown).

error_typestring nullable

error_codestring nullable

Machine-readable error code: HTTP status (e.g. '404') for external API tools, or the exception class name (e.g. 'ValueError') otherwise.

field_errorsobject nullable

Per-argument validation messages keyed by the offending field name.

truncatedboolean

Whether the result was truncated because it was too large.