# Proxies

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

> Saved proxies for sessions.

## GET /v1/proxies

List the project's saved proxies (no passwords: `hasPassword` only)

Responses: 200 `ListProxiesResponse`, default `ErrorBody`

## POST /v1/proxies

Save a proxy. The password is sealed and never returned. 400 `invalid_input` for a host that is, or resolves to, a private, loopback, link-local or metadata address

Request body (JSON): `CreateProxyRequest`

Responses: 201 `ProxyInfo`, default `ErrorBody`

## DELETE /v1/proxies/{id}

Delete a saved proxy. 404 `not_found` for an unknown or another project's proxy

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

Responses: 200 `DeleteProxyResponse`, default `ErrorBody`

## POST /v1/proxies/{id}/test

Test a saved proxy from the API: connects through it and reports `{ok, ms, exitIp?, error?}`. A failing proxy is a 200 with `ok: false` and a fixed message. 429 `rate_limited` per tenant

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

Responses: 200 `TestProxyResponse`, default `ErrorBody`