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

MethodHTTPSummary
listGET /api/toolsList tools
getGET /api/tools/{idOrName}Get a single tool
createPOST /api/toolsCreate a custom tool
updatePUT /api/tools/{idOrName}Update a tool
deleteDELETE /api/tools/{idOrName}Delete a custom tool

​
Reference

​
client.tools.list(...)

List tools HTTP — GET /api/tools · API reference → 
list(opts: { category?: string; type?: string; search?: string; limit?: number; offset?: number } = {})
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 → 
get(idOrName: string)
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 → 
create(input: ToolCreate)

​
client.tools.update(...)

Update a tool HTTP — PUT /api/tools/{id} · API reference → 
update(idOrName: string, patch: Partial<ToolCreate>)
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 → 
delete(idOrName: string)
Default (seeded) tools cannot be deleted — only custom ones. Returns 403 if the tool is default.