Skip to content

Get settings

GET
/api/v1/settings

Returns the current server-side settings including runtime, audit log state, and disconnect key.

OK

object
auditLogMode
string
Allowed values: off standard detailed
budgetActionPreventStart
boolean
budgetActionStopContainer
boolean
budgetActionStopWorktrees
boolean
budgetActionWarn

Budget enforcement actions — what happens when a project exceeds its budget.

boolean
claudeCodeVersion

Pinned CLI versions installed in containers.

string
codexVersion
string
defaultProjectBudget
number
disconnectKey
string
notificationsEnabled

NotificationsEnabled controls whether the system tray sends desktop notifications when agents need attention.

boolean
runtime
string
version

Version is the server build version (e.g. “v0.5.2”, “dev”).

string
workingDirectory

WorkingDirectory is the server process’s working directory. Used by development tooling to auto-create projects without manual path entry.

string