Execute Tool

Execute a tool and optionally speak the result.

This endpoint allows external systems (webhooks, home automation, etc.)
to trigger tool execution. The result can optionally be spoken to
an active call.

Examples:

Get weather (just data):

POST /tools/WEATHER/execute
{"tool": "WEATHER"}

Get weather and speak to call:

POST /tools/WEATHER/execute
{"tool": "WEATHER", "speak_result": true}

Execute calculation:

POST /tools/CALC/execute
{"tool": "CALC", "params": {"expression": "25 * 4"}}

Set a timer and announce it:

POST /tools/SET_TIMER/execute
{
    "tool": "SET_TIMER",
    "params": {"duration": 300, "message": "Pizza is ready!"},
    "speak_result": true
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Request to execute a tool.

string
required

Name of the tool to execute (e.g., WEATHER, DATETIME)

params
object

Parameters to pass to the tool

boolean
Defaults to false

Speak the result to the active call

Specific call to speak to (if multiple calls active)

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json