> ## Documentation Index
> Fetch the complete documentation index at: https://betterdatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Execute Tool

> Execute a commerce tool with specified arguments

## Request Body

<ParamField body="name" type="string" required>
  The name of the tool to execute (e.g. `search_products`).
</ParamField>

<ParamField body="arguments" type="object" required>
  The arguments for the tool, matching its Zod schema.
</ParamField>

<ParamField body="sessionId" type="string">
  The current conversation session ID.
</ParamField>

## Response

<ResponseField name="result" type="object">
  The data returned by the backend.
</ResponseField>

<ResponseField name="status" type="string">
  The status of the execution (`success` or `error`).
</ResponseField>

## Example

```bash theme={null}
curl -X POST https://api.betterdata.io/v1/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "search_products",
    "arguments": { "query": "blue running shoes" },
    "sessionId": "session_123"
  }'
```