---
title: "Dry-run a team-defined tool through the exact live-call executor (tools scope required)"
method: POST
path: "/api/v1/tools/test"
---

# Dry-run a team-defined tool through the exact live-call executor (tools scope required)

`POST /api/v1/tools/test`

## Request

- Base URL: `https://salestick-backend-647994203646.europe-central2.run.app`
- URL: `https://salestick-backend-647994203646.europe-central2.run.app/api/v1/tools/test`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Runs the tool with sample args and returns the interpolated request URL plus the response the voice AI would see. Do this after every create and confirm the data is correct and safe to speak aloud.

## Request body

- object
  - `name` string, required
  - `agentId` string
  - `args` object: Sample param values, e.g. {"order_number": "LV-10293"}.

## Response `200`

Executor result with debug info (requestUrl, response data or failure reason)

## Other responses

- `403`: Key lacks the tools scope
- `404`: No tool with that name

---

[API](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents.md) · [All operations](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/revisions/e89711c2f1ba?raw)