System Admin

Update a system setting value

Changed on

Persist a new value for :key. Service validates the rawValue against the registry's declared value_type and rejects mismatches with 400. SystemAdmin only. Emits an audit row (action=system.setting_changed) on success.

put/system/admin/settings/{key}

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/system/admin/settings/{key}
  • Auth
    none declared

Path parameters

keystring required

Setting key

Request body

valueunknown

Response

the updated row

categorystring

Category groups settings in the management UI ("limits", "agent", "auth", ...). Free-form string so adding a new category is a data-only change.

created_atstring
descriptionstring
enumstring[]

Enum is populated by the service layer (NOT persisted) from the in-code registry. Empty/nil means "free-form input"; non-empty means the UI should render a select with these options. Tagged gorm:"-" so GORM never tries to read/write the column.

idinteger
is_secretboolean

IsSecret reserves UI affordances for P3 (mask + reveal-with-confirm). In P1 every row is is_secret=false; service Update accepts the column but does not yet enforce special handling.

keystring
last_modified_bystring
last_modified_by_namestring

LastModifiedByName is a display label resolved from LastModifiedBy (the user's UUID) at handler time — username when available, otherwise email. Empty for virtual rows that were never persisted (LastModifiedBy=""). Not stored: derived per request so renaming a user reflects on the next reload without a backfill job.

requires_restartboolean

RequiresRestart reserves UI affordances for P3 (banner "this change won't take effect until the next restart"). In P1 the only seeded key is per-request, so always false.

updated_atstring
valueobject
value_typestring

ValueType is one of "int", "string", "bool". Service layer rejects updates whose payload type does not match; UI uses it to pick InputNumber vs Input vs Switch.

Changes