Execute tool | Runtype Documentation

Execute a tool by ID with the provided parameters. Flow tools stream an SSE response; non-flow tools return a JSON result.

AuthorizationBearer

API key or Clerk session token

idstringRequired

This endpoint expects an object.

parametersmap from strings to anyRequired

contextobjectOptional

toolIdstringOptional

Tool execution result (JSON for non-flow tools, SSE stream for flow tools)

executionIdstring

executionTimeMsdouble

statusenum

errorstring

resultany

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/tools/id/execute \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"parameters": {
>	"a": 15,
>	"b": 25,
>	"operation": "add"
>	}
>	}'