Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kataven.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.