# Settings

Source: https://webagent-docs-staging.lookover.ai/api-reference/settings

> Project and organization settings.

## GET /v1/settings/agent

Agent settings

Responses: 200 `AgentSettings`, default `ErrorBody`

## PUT /v1/settings/agent

Replace agent settings (admin)

Request body (JSON): `AgentSettingsPut`

Responses: 200 `AgentSettings`, default `ErrorBody`

## GET /v1/settings/mcp-servers

List MCP servers

Responses: 200 `McpServerList`, default `ErrorBody`

## POST /v1/settings/mcp-servers

Add an MCP server; its tools are discovered straight away (admin)

Request body (JSON): `CreateMcpServerRequest`

Responses: 201 `McpServer`, default `ErrorBody`

## PATCH /v1/settings/mcp-servers/{id}

Change an MCP server (admin)

Parameters:
- `id` (path, required): string

Request body (JSON): `PatchMcpServerRequest`

Responses: 200 `McpServer`, default `ErrorBody`

## DELETE /v1/settings/mcp-servers/{id}

Remove an MCP server (admin)

Parameters:
- `id` (path, required): string

Responses: 200 `Deleted`, default `ErrorBody`

## POST /v1/settings/mcp-servers/{id}/reconnect

Rediscover an MCP server's tools (admin)

Parameters:
- `id` (path, required): string

Responses: 200 `McpServer`, default `ErrorBody`

## PATCH /v1/settings/mcp-servers/{id}/tools/{tool}

Set one MCP tool's policy (admin)

Parameters:
- `id` (path, required): string
- `tool` (path, required): string

Request body (JSON): `ToolPolicyRequest`

Responses: 200 `McpServer`, default `ErrorBody`

## GET /v1/settings/model-routing

Model routing settings

Responses: 200 `ModelSettings`, default `ErrorBody`

## PATCH /v1/settings/model-routing

Change model routing (admin)

Request body (JSON): `ModelSettingsPatch`

Responses: 200 `ModelSettings`, default `ErrorBody`

## GET /v1/settings/models

List available models

Responses: 200 `ModelList`, default `ErrorBody`

## GET /v1/settings/providers

List model providers

Responses: 200 `ProviderList`, default `ErrorBody`

## PUT /v1/settings/providers/{id}

Connect a model provider (admin)

Parameters:
- `id` (path, required): "anthropic" | "openai" | "google" | "custom"

Request body (JSON): `ConnectProviderRequest`

Responses: 200 `ModelProvider`, default `ErrorBody`

## DELETE /v1/settings/providers/{id}

Disconnect a model provider (admin)

Parameters:
- `id` (path, required): "anthropic" | "openai" | "google" | "custom"

Responses: 200 `ModelProvider`, default `ErrorBody`

## POST /v1/settings/providers/{id}/test

Test a model provider's key (admin)

Parameters:
- `id` (path, required): "anthropic" | "openai" | "google" | "custom"

Responses: 200 `ProviderTestResult`, default `ErrorBody`

## GET /v1/settings/webhooks

List webhook endpoints

Responses: 200 `WebhookList`, default `ErrorBody`

## POST /v1/settings/webhooks

Add a webhook endpoint; the signing secret is returned once (admin)

Request body (JSON): `CreateWebhookRequest`

Responses: 201 `WebhookWithSecret`, default `ErrorBody`

## PATCH /v1/settings/webhooks/{id}

Change a webhook endpoint (admin)

Parameters:
- `id` (path, required): string

Request body (JSON): `PatchWebhookRequest`

Responses: 200 `WebhookEndpoint`, default `ErrorBody`

## DELETE /v1/settings/webhooks/{id}

Remove a webhook endpoint (admin)

Parameters:
- `id` (path, required): string

Responses: 200 `Deleted`, default `ErrorBody`

## GET /v1/settings/webhooks/{id}/deliveries

Recent deliveries of a webhook endpoint

Parameters:
- `id` (path, required): string
- `limit` (query): integer
- `state` (query): "all" | "dead"

Responses: 200 `WebhookDeliveryList`, default `ErrorBody`

## POST /v1/settings/webhooks/{id}/roll-secret

Roll a webhook's signing secret (admin)

Parameters:
- `id` (path, required): string

Responses: 200 `WebhookWithSecret`, default `ErrorBody`

## POST /v1/settings/webhooks/{id}/test

Send a test ping; answers the latest delivery or null (admin)

Parameters:
- `id` (path, required): string

Responses: 200 `WebhookTestResult`, default `ErrorBody`