---
title: "Test a tool"
method: POST
path: "/public/v1/tools/{toolId}/test"
tags: ["Custom Tools"]
---

# Test a tool

`POST /public/v1/tools/{toolId}/test`

Executes a persisted API call tool with the provided argument values and returns the HTTP response. Requires a USER API key.

## Path parameters

- `toolId` number, nullable

## Request body

- PublicToolTestInput
  - `values` object — Argument values keyed by argument name. Every declared tool argument must be present.

## Response `200`

Tool test result

- PublicToolTestOutput
  - `status` number, required
  - `headers` object, required
  - `data` object, nullable
  - `duration` number, required — Request duration in milliseconds
  - `contentLength` number, nullable

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/versions/9d33b6aad674/schema)