---
title: "Validate Parameter Configs"
method: POST
path: "/api/v1/tool-parameters/validate"
tags: ["Tool Parameters"]
---

# Validate Parameter Configs

`POST /api/v1/tool-parameters/validate`

Validate parameter configs against a tool's schema.

The frontend sends both the configs and the params_schema it has (from the tool
object). This keeps validation stateless and avoids any DB lookup.

## Request body

- ValidateConfigsRequest — Request body for config validation.
  - `configs` ToolParameterConfigInput[], required
    - `param_name` string, required
    - `fill_mode` 'ask_caller' | 'fixed_value' | 'use_default', required — Determines how a tool parameter gets its value during execution.
    - `fixed_value` string, nullable
    - `prompt_hint` string, nullable
    - `default_fallback` string, nullable
    - `required` boolean
    - `allowed_values` string[], nullable
  - `params_schema` object, required

## Response `200`

Successful Response

- ValidateConfigsResponse — Response from config validation.
  - `valid` boolean, required
  - `errors` string[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)