---
title: "List all system settings"
method: GET
path: "/system/admin/settings"
tags: ["System Admin"]
---

# List all system settings

`GET /system/admin/settings`

Return every row in the system_settings table (system-scope,
not tenant-scope). SystemAdmin only.

## Response `200`

list of settings

- GithubComTencentWeKnoraInternalTypesSystemSetting[]
  - `category` string — Category groups settings in the management UI ("limits", "agent", "auth", ...). Free-form string so adding a new category is a data-only change.
  - `created_at` string
  - `description` string
  - `enum` string[] — 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.
  - `id` integer
  - `is_secret` boolean — 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.
  - `key` string
  - `last_modified_by` string
  - `last_modified_by_name` string — 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_restart` boolean — 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_at` string
  - `value` integer[]
  - `value_type` string — 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.

## Other responses

- `403` — Forbidden: not a system admin

## Changes

- **2026-06-05** `e7c0c953963b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/system/admin/settings/get.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/d113fcd208b2/schema)