---
title: "Send a real test request using an already-saved tool's real address and headers"
method: POST
path: "/v1/tools/{id}/test"
---

# Send a real test request using an already-saved tool's real address and headers

`POST /v1/tools/{id}/test`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/tools/{id}/test`
- Auth: HTTP bearer

Tests an ALREADY-SAVED tool by `id` - the body is always empty `{}`, the endpoint takes the address, method and REAL (unmasked) headers from the saved record, not from the request body. `private_address`/`invalid_tool_params`/`invalid_tool_headers` can't come back here (the saved record doesn't go through input validation again) - a network error still collapses into `invalid_tool_url`.

## Path parameters

- `id` string, required

## Request body

- object

## Response `200`

Test result

- object
  - `status` number, required
  - `durationMs` number, required
  - `body` string, required
  - `note` string, nullable, required

## Other responses

- `400`: Error codes: validation (request), invalid_tool_url (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: tool_not_found (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)