---
title: "Create Search Tool"
method: POST
path: "/search_tools"
tags: ["Search Tools"]
---

# Create Search Tool

`POST /search_tools`

Create a new search tool.

Example Request:
```bash
curl -X POST "http://localhost:4000/search_tools" \
    -H "Authorization: Bearer <your_api_key>" \
    -H "Content-Type: application/json" \
    -d '{
        "search_tool": {
            "search_tool_name": "litellm-search",
            "litellm_params": {
                "search_provider": "perplexity",
                "api_key": "sk-..."
            },
            "search_tool_info": {
                "description": "Perplexity search tool"
            }
        }
    }'
```

Example Response:
```json
{
    "search_tool_id": "123e4567-e89b-12d3-a456-426614174000",
    "search_tool_name": "litellm-search",
    "litellm_params": {
        "search_provider": "perplexity",
        "api_key": "sk-..."
    },
    "search_tool_info": {
        "description": "Perplexity search tool"
    },
    "created_at": "2023-11-09T12:34:56.789Z",
    "updated_at": "2023-11-09T12:34:56.789Z"
}
```

## Request body

- CreateSearchToolRequest
  - `search_tool` SearchTool, required — Search tool configuration. Example: { "search_tool_id": "123e4567-e89b-12d3-a456-426614174000", "search_tool_name": "litellm-search", "litellm_params": { "search_provider": "perplexity", "api_key": "sk-..." }, "search_tool_info": { "description": "Perplexity search tool" } }
    - `search_tool_id` string, nullable
    - `search_tool_name` string, required
    - `litellm_params` SearchToolLiteLLMParams, required — LiteLLM params for search tools configuration.
      - `search_provider` string, required
      - `api_key` string, nullable
      - `api_base` string, nullable
      - `timeout` number, nullable
      - `max_retries` integer, nullable
    - `search_tool_info` object, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)