Update a tool description
Change only the description of one existing in-call tool. First use Get agent with view=tools, then copy the installed tool’s exact tools[].name into toolName. For example, an installed tool with name: "transfer_call" is updated with toolName: "transfer_call". Names are case-sensitive.
List available tools is a catalog: its name is a display label such as “Live Transfer”, and its type identifies the kind of skill to install. Neither is necessarily the installed tool name. One catalog entry can create several tools; use the installed inventory to select the one to edit. This operation does not install a tool.
If a skill owns the tool, a later skill save may regenerate its description, so edit the owning skill instead.
Required API key scope: agents:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Path Parameters
Agent id.
1Body
Exact, case-sensitive tools[].name from Get agent (GET /api/agent-builder/agents/{id}?view=tools). For example, use transfer_call, not the catalog display name Live Transfer. The tool must already be installed on this agent.
1"transfer_call"
When the agent should use this installed tool. Updates its description only, not its configuration or implementation.
600