Skip to main content
POST
Run Tool

Authorizations

Authorization
string
header
required

Your SLNG consumer API key.

Path Parameters

tool_id
string<uuid>
required

The tool UUID. Curated tools are visible but read-only, and a tool owned by another organisation returns 404.

Body

application/json

The sample input and side-effect confirmation for the test run.

Test-run request with sample input and explicit confirmation of side effects.

confirm_side_effects
boolean
required
sample_input
Sample Input · object

Response

The result of the test run: status, latency, any returned output, output-schema validation, logs, and the publish gate status.

Outcome of a test run, including status, latency, output, and gate status.

status
enum<string>
required
Available options:
succeeded,
failed,
timed_out
latency_ms
integer
required
validation
enum<string>
required

Whether the run output matched the declared output schema: valid (matched), mismatch (did not match), or na (no schema to check against).

Available options:
valid,
mismatch,
na
output_json
unknown
logs
string[]
error
string | null
proven_hash
string | null
gate_status
GateStatus · object | null

Gate set is selected by tool_type (V2): data → static + green_run; code also reports config_valid; ctx-bound → config_valid ONLY.