Skip to main content

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_ids on Update agent)
  • Test a tool safely

The tool catalog

Returns { "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

Lists accept page and limit and report X-Total-Count, X-Page and X-Per-Page.

Assigning tools to an agent

Assign tools with tool_ids on Update agent. The list is the whole set for that agent:
Once assigned, the tool is available during the agent’s next call. No restart needed. A tool left out of tool_ids is unassigned from the agent but stays configured in your workspace.

Updating, testing and deleting

For a tool that belongs to one agent, add ?agent_id=AGENT_ID to the same calls.

End-to-end: equipping an agent for demos

Now the demo agent can answer product questions from the knowledge base and book meetings directly during a call. Finish each tool’s setup (selected knowledge bases, a connected calendar) as its setup_requirements describe.