Reference

Configuration

Driven by appsettings.json, environment variables (with the __ separator), or a Kubernetes ConfigMap. The same keys work across all three.

Database

Key	Default	Notes
`Database__Provider`	`Sqlite`	Also `Postgres`, `SqlServer`.
`Database__Path`	`adaptiveapi.db`	SQLite only.
`Database__ConnectionString`	none	Required for Postgres and SQL Server.

Translators

Key	Default	Notes
`Translators__Default`	`passthrough`	Also `deepl`, `llm`.
`Translators__DeepL__ApiKey`	none	Required for `deepl`.
`Translators__DeepL__BaseUrl`	`https://api.deepl.com/`	Use `https://api-free.deepl.com/` for free tier.
`Translators__Llm__ApiKey`	none	Required for `llm`.
`Translators__Llm__BaseUrl`	`https://api.openai.com/`	Any OpenAI-compatible endpoint.
`Translators__Llm__Model`	`gpt-4o-mini`	Translator model.

MCP

Key	Default	Notes
`Mcp__CatalogFile`	`catalog/mcp-servers.json`	Curated server list shown in admin UI.

Public surface

Key	Default	Notes
`PublicBaseUrl`	`http://localhost:8080`	External URL of the API. Used in copy-paste snippets.
`ASPNETCORE_URLS`	`http://+:8080`	Bind address.
`ASPNETCORE_ENVIRONMENT`	`Development`	Use `Production` in prod.

Development helpers

Key	Default	Notes
`Dev__FixedRouteToken`	none	Seed a stable route token at startup. Local only.

PII redactor

Key	Default	Notes
`PiiRedactor__Provider`	`regex`	Also `presidio`.
`PiiRedactor__Presidio__BaseUrl`	none	Required for `presidio`.

Telemetry

Key	Default	Notes
`OTEL_EXPORTER_OTLP_ENDPOINT`	none	OTLP collector address. Enables spans + metrics export.
`OTEL_SERVICE_NAME`	`adaptiveapi`	Service name in traces.

Worked appsettings.json

{
  "Database": {
    "Provider": "Postgres",
    "ConnectionString": "Host=postgres;Database=adaptiveapi;Username=adaptiveapi;Password=..."
  },
  "Translators": {
    "Default": "deepl",
    "DeepL": {
      "ApiKey": "...",
      "BaseUrl": "https://api.deepl.com/"
    }
  },
  "PiiRedactor": {
    "Provider": "presidio",
    "Presidio": { "BaseUrl": "http://presidio:5002" }
  },
  "PublicBaseUrl": "https://adaptiveapi.example.com"
}

Same thing as env vars

Database__Provider=Postgres
Database__ConnectionString=Host=postgres;Database=adaptiveapi;Username=adaptiveapi;Password=...
Translators__Default=deepl
Translators__DeepL__ApiKey=...
PiiRedactor__Provider=presidio
PiiRedactor__Presidio__BaseUrl=http://presidio:5002
PublicBaseUrl=https://adaptiveapi.example.com