Skip to main content
ToolsResource is reachable on every Kataven Node client as client.tools. Each method maps to one HTTP endpoint on the Hub API; links to the underlying spec entry are inline below. Browse the tool catalog and author custom tools. Tools are functions an agent can call mid-conversation.

​
Methods at a glance

​
Reference

​
client.tools.list(...)

List tools HTTP — GET /api/tools · API reference →
Returns the catalog of tools available in this account, paginated and filterable. Includes category counts for filter UIs.

​
client.tools.get(...)

Get a single tool HTTP — GET /api/tools/{id} · API reference →
Looks up the tool by uuid or by snake_case name. Returns 404 if neither matches.

​
client.tools.create(...)

Create a custom tool HTTP — POST /api/tools · API reference →

​
client.tools.update(...)

Update a tool HTTP — PUT /api/tools/{id} · API reference →
Patches description / schema / implementation_config / implementation_code / tags. Default tools are flipped to modified_from_default=TRUE so re-seeds skip them.

​
client.tools.delete(...)

Delete a custom tool HTTP — DELETE /api/tools/{id} · API reference →
Default (seeded) tools cannot be deleted — only custom ones. Returns 403 if the tool is default.