Read the AI provider configuration

GET

/admin/system/ai

Local development behind nginx (port 8088 by default)

Authorizations

cookieAuth
bearerAuth

Responses

200

Current AI config

AI provider configuration. Persisted under the sysconfig key ai. API keys are stored as plain strings for now (admin- only table; never federated); a secrets-backend migration is planned.

object

default_provider_id

Picks the providers[*].id used when nothing else specifies. Empty = no default (callers must choose, or AI features stay disabled).

string

providers

required

Array<object>

object

string

kind

required

string

Allowed values: openai anthropic google local

enabled

required

boolean

display_name

required

string

model

E.g. gpt-4o, claude-sonnet-4-6

string

base_url

Override for self-hosted / proxied endpoints.

string

api_key

Raw API key (interim — will move to a secrets backend reference). Sent and stored as-is.

string

config

Per-kind opaque config (temperature defaults, system prompts, rate limits, …). Integration code owns the schema.

object

key

additional properties

any

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed