Execute Tool

Request Body

name · string · required

The name of the tool to execute (e.g. search_products).

arguments · object · required

The arguments for the tool, matching its Zod schema.

sessionId · string

The current conversation session ID.

Response

result · object

The data returned by the backend.

status · string

The status of the execution (success or error).

Example

1curl -X POST https://api.betterdata.io/v1/execute \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "name": "search_products",
6    "arguments": { "query": "blue running shoes" },
7    "sessionId": "session_123"
8  }'