Overview
Tools (also called skills) extend what your AI voice agent can do during a live call. Instead of just talking, the agent can take actions: look up calendar availability, book meetings, search your knowledge base, transfer the call, and more. The tools endpoints let you:- Browse the built-in tool catalog (
GET /tools?catalog=true) - Create, read, update and delete tools for your workspace
- Assign tools to specific voice agents (
tool_idson Update agent) - Test a tool safely
The tool catalog
{ "tools": [...] }. Each entry describes one capability:
kind is sendora_http for built-in capabilities, custom_http for an HTTP endpoint you host, or builtin for call controls. setup_requirements says what must exist before the tool works. Add agent_id to get the catalog for one agent.
Creating a tool
kind is required. For a custom tool also send http_url, http_method, and its parameters (dynamic_parameters, static_parameters). Custom tools can create external side effects, so restrict their destination, inputs and permissions.
Some tools exist only on a single agent: direct booking, email, text, transfer and call control. Create those with agent_id, which creates the tool on that agent only:
Reading tools
page and limit and report X-Total-Count, X-Page and X-Per-Page.
Assigning tools to an agent
Assign tools withtool_ids on Update agent. The list is the whole set for that agent:
tool_ids is unassigned from the agent but stays configured in your workspace.
Updating, testing and deleting
?agent_id=AGENT_ID to the same calls.
End-to-end: equipping an agent for demos
setup_requirements describe.