---
title: "Get a single system setting by key"
method: GET
path: "/system/admin/settings/{key}"
tags: ["System Admin"]
---

# Get a single system setting by key

`GET /system/admin/settings/{key}`

Returns the row matching :key. 404 when the key is unknown
to the registry; 200 with the row when known.

## Path parameters

- `key` string, required

## Response `200`

the setting row

- 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

- `400` — Unknown key
- `404` — Key registered but DB row absent

---

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