Execute Tool

POST https://example.com/tools/{tool_name}/execute

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
}