---
title: "Test Service"
method: POST
path: "/v1/tool-settings/{service}/test"
tags: ["tool-settings"]
---

# Test Service

`POST /v1/tool-settings/{service}/test`

Structurally validate a URL and probe it for reachability.

Tests the URL in the request body (typically unsaved), so an operator can
verify before saving. The probe is a plain HTTP GET with a short timeout: any
HTTP response means the host is reachable; a connection/timeout/DNS error means
it is not. The operator is trusted (master key), so no SSRF deny-list applies;
only the structural check (http/https + host) runs first.

## Path parameters

- `service` string, required

## Request body

- TestServiceRequest — A (typically unsaved) URL to probe for reachability.
  - `url` string, required

## Response `200`

Successful Response

- TestServiceResponse
  - `ok` boolean, required
  - `reason` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/cea76e85cdac/schema)