---
title: "Retrieve Server Settings"
method: GET
path: "/api/v1/settings"
tags: ["Settings"]
---

# Retrieve Server Settings

`GET /api/v1/settings`

Returns the server's current in-memory settings view as the typed `ServerSettings` payload.

## Response `200`

Server settings

- ServerSettings — Current in-memory server settings view.
  - `server` ServerNamespace, required
    - `listen` union, required
      - ServerListenTcpSettings
        - `type` 'tcp', required
        - `address` string, required
      - ServerListenUnixSettings
        - `type` 'unix', required
        - `path` string, required
    - `api` ServerApiSettings, required
      - `url` string, nullable, required
    - `web` ServerWebSettings, required
      - `enabled` boolean, required
      - `url` string, required
    - `auth` ServerAuthSettings, required
      - `methods` ServerAuthMethod[], required
      - `github` ServerAuthGithubSettings, required
        - `allowed_usernames` string[], required
    - `sandbox` ServerSandboxSettings, required
      - `providers` ServerSandboxProvidersSettings, required — Sandbox provider policy keyed by provider kind. The bundled kinds (`local`, `docker`, `daytona`) are always present; any other key names a sandbox-driver plugin and carries its launch settings.
    - `storage` ServerStorageSettings, required
      - `root` string, required
    - `artifacts` ServerArtifactsSettings, required
      - `prefix` string, required
      - `store` union, required
        - ObjectStoreLocalSettings
          - `type` 'local', required
          - `root` string, required
        - ObjectStoreS3Settings
          - `type` 's3', required
          - `bucket` string, required
          - `region` string, required
          - `endpoint` string, nullable, required
          - `path_style` boolean, required
    - `slatedb` ServerSlateDbSettings, required
      - `prefix` string, required
      - `store` union, required
        - ObjectStoreLocalSettings
          - `type` 'local', required
          - `root` string, required
        - ObjectStoreS3Settings
          - `type` 's3', required
          - `bucket` string, required
          - `region` string, required
          - `endpoint` string, nullable, required
          - `path_style` boolean, required
      - `flush_interval` string, required
      - `disk_cache` boolean, required
    - `scheduler` ServerSchedulerSettings, required
      - `max_concurrent_runs` integer, required
    - `logging` ServerLoggingSettings, required
      - `level` string, nullable, required
      - `destination` 'file' | 'stdout', required
    - `integrations` ServerIntegrationsSettings, required
      - `github` GithubIntegrationSettings, required
        - `enabled` boolean, required
        - `strategy` 'token' | 'app', required
        - `app_id` string, nullable, required
        - `client_id` string, nullable, required
        - `slug` string, nullable, required
        - `webhooks` IntegrationWebhooksSettings, required
          - `strategy` 'tailscale_funnel' | 'server_url', required
      - `slack` SlackIntegrationSettings, required
        - `enabled` boolean, required
        - `default_channel` string, nullable, required

## Changes

- **2026-09-10** `478e995209e9` — 3 breaking
  - removed the required property `server/sandbox/providers/daytona` from the response with the `200` status
  - removed the required property `server/sandbox/providers/docker` from the response with the `200` status
  - removed the required property `server/sandbox/providers/local` from the response with the `200` status
- **2026-09-09** `64d7e2ed03af` — 3 info
  - added the required property `server/sandbox/providers/daytona` to the response with the `200` status
  - added the required property `server/sandbox/providers/docker` to the response with the `200` status
  - added the required property `server/sandbox/providers/local` to the response with the `200` status
- **2026-09-08** `9aaa5d3a64cc` — 3 breaking
  - removed the required property `server/sandbox/providers/daytona` from the response with the `200` status
  - removed the required property `server/sandbox/providers/docker` from the response with the `200` status
  - removed the required property `server/sandbox/providers/local` from the response with the `200` status
- **2026-05-28** `375e89f4b7de` — 2 breaking
  - removed the required property `server/integrations/github/webhooks/oneOf[#/components/schemas/IntegrationWebhooksSettings]/ip_allowlist` from the response with the `200` status
  - removed the required property `server/ip_allowlist` from the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/settings/get.md)

---

[API](https://skmtc.dev/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.dev/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fabro-sh/apis/fabro-run-api/revisions/1258a4cf33df?raw)