---
title: "Test Assistant Tool"
method: POST
path: "/ai/assistants/{assistant_id}/tools/{tool_id}/test"
tags: ["Assistants"]
---

# Test Assistant Tool

`POST /ai/assistants/{assistant_id}/tools/{tool_id}/test`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/assistants/{assistant_id}/tools/{tool_id}/test`
- Auth: HTTP bearer

Executes a test invocation of the specified webhook tool for the assistant and returns the outcome, so you can verify the webhook's behavior before relying on it in conversations.

## Path parameters

- `assistant_id` string, required
- `tool_id` string, required

## Request body

- TestWebhookToolRequest: Request model for testing a webhook tool
  - `arguments` object: Key-value arguments to use for the webhook test
  - `dynamic_variables` object: Key-value dynamic variables to use for the webhook test

## Response `200`

Successful Response

- TestWebhookToolResponseData: Response model for webhook tool test results
  - `data` TestWebhookToolResponse, required: Response model for webhook tool test results
    - `success` boolean, required
    - `status_code` integer, required
    - `content_type` string, required
    - `response` string, required
    - `request` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/f82938f53ff4?raw)