---
title: "修改网络搜索服务设置"
method: PATCH
path: "/web-search-providers/{id}"
tags: ["网络搜索"]
---

# 修改网络搜索服务设置

`PATCH /web-search-providers/{id}`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/web-search-providers/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

## Path parameters

- `id` string, required

## Request body

- InternalHandlerPatchWebSearchProviderRequest
  - `description` string: Description; empty clears it.
  - `is_default` boolean: Whether agents without an explicit provider use this service by default.
  - `name` string: Display name; cannot be blank.

## Response `200`

OK

- object
  - `data` GithubComTencentWeKnoraInternalHandlerDtoWebSearchProviderResponse
    - `created_at` string
    - `credentials` object: Per-field "configured?" map. See MCPServiceResponse.Credentials.
    - `description` string
    - `id` string
    - `is_default` boolean
    - `name` string
    - `parameters` GithubComTencentWeKnoraInternalHandlerDtoWebSearchProviderParametersDTO
      - `base_url` string
      - `engine_id` string
      - `extra_config` object
      - `proxy_url` string
    - `provider` 'brave' | 'bing' | 'google' | 'duckduckgo' | 'tavily' | 'ollama' | 'baidu' | 'searxng' | 'keenable' | 'zhipu' | 'exa' | 'metaso' | 'bocha' | 'serply'
    - `tenant_id` integer
    - `updated_at` string
  - `success` boolean

## Changes

- **2026-10-17** `de9fb40c7476`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/web-search-providers/:id/patch.md)

---

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