Core resources

Tools

Tools are functions the assistant can call mid-conversation (function calling) — e.g. look up an order, book a slot, hit your API. Define a tool with a name, description, JSON-schema parameters and a webhook/handler, then attach it to an assistant.

GET/tools tools:read

List tools

List tools in the workspace.

Example request

bash

curl https://api.bolchoai.in/v1/tools -H "Authorization: Bearer $VOXA_API_KEY"

POST/tools tools:write

Create tool

Define a function-calling tool.

Body

name*	string	Tool name (function name).
description*	string	What it does — guides the LLM on when to call it.
parameters	object	JSON Schema of the arguments.
url	string	Webhook invoked with the arguments.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/tools \
  -H "Authorization: Bearer $VOXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "description": "string",
  "parameters": {},
  "url": "string"
}'

PATCH/tools/{id} tools:write

Update tool

Update a tool's definition.

Path parameters

id*

uuid

Tool id.

Example request

bash

curl -X PATCH https://api.bolchoai.in/v1/tools/$ID \
  -H "Authorization: Bearer $VOXA_API_KEY"

POST/tools/{id}/invoke tools:write

Test invoke

Invoke the tool with sample arguments to test the handler.

Path parameters

id*

uuid

Tool id.

Example request

bash

curl -X POST https://api.bolchoai.in/v1/tools/$ID/invoke \
  -H "Authorization: Bearer $VOXA_API_KEY"

DELETE/tools/{id} tools:write

Delete tool

Delete a tool.

Path parameters

id*

uuid

Tool id.

Example request

bash

curl -X DELETE https://api.bolchoai.in/v1/tools/$ID \
  -H "Authorization: Bearer $VOXA_API_KEY"