> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Protector Plus Config

> Read, update, and test the TraceCtrl Guards (Protector Plus) configuration

These endpoints manage the global TraceCtrl Guards configuration used to call the Protector Plus service.

## Get config (redacted)

```http theme={"dark"}
GET http://localhost:8000/api/v1/guardrails/protector-config
```

Returns the stored config with `api_key` redacted (e.g. `hOjm***vY2`) so it can be safely surfaced in the Settings UI. If no config is set, returns an empty object with empty strings and an empty `enabled_guardrails` array.

### Response — `ProtectorConfig`

**endpoint\_url** `string`

Protector Plus endpoint URL

**api\_key** `string`

Redacted API key (first 4 chars + `***` + last 3)

**enabled\_guardrails** `string[]`

List of enabled Protector Plus guardrails

**updated\_at** `string`

ISO-8601 timestamp, or `null` if never set

## Upsert config

```http theme={"dark"}
PUT http://localhost:8000/api/v1/guardrails/protector-config
```

Upserts the global config. The full `api_key` must be provided in the body. The response is returned in **redacted** form so the UI does not see its freshly-sent key echoed back.

### Request body — `ProtectorConfigUpsert`

**endpoint\_url** `string` *required*

Protector Plus base URL (`http` or `https`). Trailing slash is stripped before storage.

**api\_key** `string` *required*

Full API key.

**enabled\_guardrails** `string[]` *required*

List of guardrail names. Each must be a known Protector Plus guardrail.

### Errors

* `400` — `endpoint_url is required`
* `400` — `api_key is required`
* `400` — URL fails SSRF validation (private/loopback/reserved IP, bad scheme, DNS failure)
* `400` — `unknown guardrails: [...]` if a name is not in `PROTECTOR_GUARDRAILS`

### Response

Same `ProtectorConfig` shape as the GET above (redacted).

## Test config

```http theme={"dark"}
POST http://localhost:8000/api/v1/guardrails/protector-test
```

Server-side health check against the stored endpoint. Issues a GET to `{endpoint_url}/api/protectorplus/v1/health` with a 5s timeout. Rejects non-public targets so the test cannot be turned into an SSRF probe.

### Response — `ProtectorTestResult`

**ok** `boolean`

`true` if the upstream returned a 2xx

**ms** `integer`

Round-trip time in milliseconds

**status\_code** `integer`

HTTP status code from the upstream, or `null`

**error** `string`

Error description when `ok` is false, otherwise `null`

## SDK config fetch

```http theme={"dark"}
GET http://localhost:8000/api/v1/guardrails/protector-config/sdk
```

Returns the **unredacted** config for the SDK. Called once per agent process during `with tracectrl.guardrails():` setup. There is **no authentication** in v1 — the deployment is expected to bind the port to loopback or front it with an authenticated proxy. Returns an empty config (rather than 404) if none is set so the SDK can no-op cleanly.

### Response — `ProtectorConfigUpsert`

**endpoint\_url** `string`

Protector Plus endpoint URL

**api\_key** `string`

Full API key

**enabled\_guardrails** `string[]`

Enabled guardrails


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.