---
title: "List Test Tools"
method: GET
path: "/v1/agent/agents/{agent_id}/test-tools"
tags: ["Agent Tests"]
---

# List Test Tools

`GET /v1/agent/agents/{agent_id}/test-tools`

## Request

- Base URL: `https://api.fish.audio`
- URL: `https://api.fish.audio/v1/agent/agents/{agent_id}/test-tools`
- Auth: HTTP bearer

The tools a test can reference for this agent, exactly what a
conversation on its draft offers. Use these ids in a test's tool mocks,
assertions and `referenced_tool`, including integration tools such as
`google_calendar:create_event`.

## Path parameters

- `agent_id` string, required

## Response `200`

Request fulfilled, document follows

- object
  - `tools` PublicAgentTestTool[], required
    - `id` string, required: The id to reference in tests. Webhook and client tools use their tool id, integration tools use <provider_key>:<tool_name>.
    - `name` string, required
    - `type` 'webhook' | 'client' | 'integration', required
    - `description` string
    - `provider_key` string, nullable: The integration provider, integration tools only.
    - `writes` boolean: An integration tool that changes data. It cannot run for real in a test.
    - `has_own_mock` boolean: The tool answers from its own mock when a simulation mocks every tool and the test has no entry for it.
    - `expects_response` boolean: False for a client tool that does not wait for an answer, which cannot be mocked.
    - `available_on_phone` boolean: False for client tools, which need a client and never run on phone calls.

## Other responses

- `401`: No permission -- see authorization schemes
- `404`: Nothing matches the given URI
- `503`: The server cannot process the request due to a high load

## Changes

- **2026-11-03** `42ac421f7a12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fish/apis/fishaudio-openapi/changes/v1/agent/agents/:agent_id/test-tools/get.md)

---

[API](https://skmtc.dev/fish/apis/fishaudio-openapi.md) - [All operations](https://skmtc.dev/fish/apis/fishaudio-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fish/apis/fishaudio-openapi/revisions/42ac421f7a12?raw)