Create Tool
Create a new custom HTTP tool.
Authorizations
Workspace API key (e.g. kej_live_...)
Body
Create a custom HTTP tool.
Tool name (unique per workspace)
1 - 100HTTP configuration
Display name
Description of when the tool should be used
Parameters provided by the AI agent at runtime with location routing
Fixed parameters always sent with requests
Expected response format
Tool timeout in milliseconds
1000 <= x <= 60000Number of retries on failure
0 <= x <= 5Voice only: if true, Ultravox may invoke this tool speculatively. Safe only for non-mutating tools. Ignored for chat.
Voice only: how the agent reacts when this tool fires. Ignored for chat.
speaks, silent, speaks-once Response
Successful Response
A custom HTTP tool (public-safe response).
How the voice agent reacts when a tool call fires.
Ultravox-specific. Ignored by chat tool-calling.
- SPEAKS: agent speaks naturally around the tool call (Ultravox default)
- SILENT: agent stays silent until the tool returns
- SPEAKS_ONCE: agent speaks at most one filler line during the tool call
speaks, silent, speaks-once 
