---
title: "Get all web search providers"
method: GET
path: "/configurationManager/web-search"
tags: ["Web Search"]
---

# Get all web search providers

`GET /configurationManager/web-search`

Retrieve all configured web search providers and current web search settings.

**Authentication:** Session JWT or OAuth 2.0 access token via `Authorization: Bearer`.
OAuth tokens must include the `config:read` scope. Admin role is not required.

## Response `200`

Web search providers and settings retrieved

- WebSearchProvidersResponse — Response for getWebSearchProviders
  - `status` 'success', required
  - `providers` WebSearchProviderItem[], required
    - `provider` 'duckduckgo' | 'serper' | 'tavily' | 'exa', required — Supported web search provider
    - `providerKey` string, required — Unique key for the provider configuration
    - `configuration` object, required — Provider-specific configuration as stored and returned by the gateway (open record). Serper, Tavily, and Exa typically include `apiKey`; additional keys may be present.
    - `isDefault` boolean, required
  - `settings` WebSearchSettings, required — Normalized web search global settings returned by getWebSearchProviders
    - `includeImages` boolean, required — Whether to include images in search results
    - `maxImages` integer — Maximum number of images to return when includeImages is true
  - `message` string, required — Human-readable status (empty list vs populated providers)

## Other responses

- `401` — Missing or invalid Bearer token
- `403` — Forbidden — OAuth token missing `config:read` scope

---

[API](https://skmtc.net/pipeshub-ai/apis/pipeshub-api.md) · [All operations](https://skmtc.net/pipeshub-ai/apis/pipeshub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipeshub-ai/pipeshub-api/versions/abd27cfefc73/schema)