---
title: "Get resolved system setting"
method: GET
path: "/api/{org_id}/settings/v2/{key}"
tags: ["Organizations"]
---

# Get resolved system setting

`GET /api/{org_id}/settings/v2/{key}`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/settings/v2/{key}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/settings/v2/:key/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a setting value with multi-level resolution. Checks user-level first, then org-level, then system-level defaults. Returns the most specific setting found, or null if no setting exists at any level.

## Path parameters

- `org_id` string, required
- `key` string, required

## Query parameters

- `user_id` string

## Response `200`

Success

- SystemSetting: A system setting record
  - `created_at` integer: Created timestamp (microseconds)
  - `created_by` string, nullable: User who created this setting
  - `description` string, nullable: Optional description
  - `id` integer, nullable: Unique identifier
  - `org_id` string, nullable: Organization ID (required for org/user scope)
  - `scope` 'system' | 'org' | 'user', required: Setting scope levels
  - `setting_category` string, nullable: Optional category for grouping
  - `setting_key` string, required: Setting key identifier
  - `setting_value` unknown, required
  - `updated_at` integer: Updated timestamp (microseconds)
  - `updated_by` string, nullable: User who last updated this setting
  - `user_id` string, nullable: User ID (required for user scope)

## Other responses

- `400`: Failure

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)