---
title: "Load Settings"
method: GET
path: "/api/settings"
---

# Load Settings

`GET /api/settings`

## Response `200`

Successful Response

- GETSettingsModel — Settings with additional token data for the frontend
  - `language` string, nullable
  - `agent` string, nullable
  - `max_iterations` integer, nullable
  - `security_analyzer` string, nullable
  - `confirmation_mode` boolean, nullable
  - `llm_model` string, nullable
  - `llm_api_key` string, password, nullable
  - `llm_base_url` string, nullable
  - `remote_runtime_resource_factor` integer, nullable
  - `secrets_store` UserSecretsOutput
    - `provider_tokens` object
    - `custom_secrets` object
  - `enable_default_condenser` boolean
  - `enable_sound_notifications` boolean
  - `enable_proactive_conversation_starters` boolean
  - `enable_solvability_analysis` boolean
  - `user_consents_to_analytics` boolean, nullable
  - `sandbox_base_container_image` string, nullable
  - `sandbox_runtime_container_image` string, nullable
  - `mcp_config` MCPConfig — Configuration for MCP (Message Control Protocol) settings. Attributes: sse_servers: List of MCP SSE server configs stdio_servers: List of MCP stdio server configs. These servers will be added to the MCP Router running inside runtime container. shttp_servers: List of MCP HTTP server configs.
    - `sse_servers` MCPSSEServerConfig[]
      - `url` string, required
      - `api_key` string, nullable
    - `stdio_servers` MCPStdioServerConfig[]
      - `name` string, required
      - `command` string, required
      - `args` string[]
      - `env` object
    - `shttp_servers` MCPSHTTPServerConfig[]
      - `url` string, required
      - `api_key` string, nullable
  - `search_api_key` string, password, nullable
  - `sandbox_api_key` string, password, nullable
  - `max_budget_per_task` number, nullable
  - `email` string, nullable
  - `email_verified` boolean, nullable
  - `git_user_name` string, nullable
  - `git_user_email` string, nullable
  - `provider_tokens_set` object, nullable
  - `llm_api_key_set` boolean, required
  - `search_api_key_set` boolean

## Other responses

- `401` — Invalid token
- `404` — Settings not found

---

[API](https://skmtc.dev/all-hands/apis/openhands.md) · [All operations](https://skmtc.dev/all-hands/apis/openhands/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/all-hands/openhands/revisions/4daa2bb4dbf1/schema)