---
title: "Test an HTTP tool configuration"
method: POST
path: "/v3/automation-tools/test"
tags: ["v3", "automation-tools"]
---

# Test an HTTP tool configuration

`POST /v3/automation-tools/test`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v3/automation-tools/test`
- Auth: HTTP bearer

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- AutomationToolTestRequest: Request schema for testing an HTTP tool configuration without saving it.
  - `tool_id` string, nullable: Existing tool UUID used to reuse Vault credentials when auth_secret is omitted
  - `name` string, nullable
  - `http_method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', required
  - `http_url` string, required: Target URL (may contain {{template}} vars)
  - `auth_type` 'NONE' | 'API_KEY' | 'BEARER_TOKEN' | 'BASIC_AUTH'
  - `auth_secret` object, nullable: Auth credentials for test-only execution. For API_KEY: {header_name, api_key}. For BEARER_TOKEN: {token}. For BASIC_AUTH: {username, password}.
  - `headers` object, nullable: Static HTTP headers
  - `query_params` object, nullable: Static query parameters
  - `body_template` object, nullable: JSON body template
  - `timeout_seconds` integer: Request timeout in seconds
  - `test_arguments` object: Template variables used for rendering URL/headers/query/body during test

## Response `200`

Successful Response

- AutomationToolTestResponse: Response schema for HTTP tool test execution.
  - `success` boolean, required
  - `message` string, required
  - `status_code` integer, nullable
  - `body` unknown
  - `error` string, nullable

## Other responses

- `422`: Validation Error

---

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