> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovseal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings Persistence

> Persist user dashboard settings and preferences.

<style>
  {`
      main, article, .prose {
        margin-left: 2.5cm !important;
        margin-right: 2.5cm !important;
      }
      `}
</style>

These endpoints allow clients to persist account-level dashboard preferences on the server. Preferences are saved as a JSONB object on the user's row and are not part of the zero-knowledge encrypted memory layer.

<Warning>
  **Session JWT Required**

  These routes manage account preferences and require the user's WorkOS AuthKit session JWT.
</Warning>

***

## 1. Retrieve Settings

Fetch user dashboard settings. If no settings have been saved yet, default fallback settings are returned.

```http theme={null}
GET /settings
```

**Response (200 OK)**

```json theme={null}
{
  "settings": {
    "project_name": "default-project",
    "project_desc": "Main trading agent workspace",
    "session_lock": false,
    "hosted_sync": true,
    "telemetry_opt_in": false
  }
}
```

***

## 2. Update Settings

Partially update one or more settings fields. Unknown parameters are ignored, and malformed types throw a `400` validation error.

```http theme={null}
PUT /settings
```

**Request Body**

```json theme={null}
{ "project_name": "production-agent-v3", "telemetry_opt_in": true }
```

**Response (200 OK)** — returns the fully updated settings configuration:

```json theme={null}
{
  "settings": {
    "project_name": "production-agent-v3",
    "project_desc": "Main trading agent workspace",
    "session_lock": false,
    "hosted_sync": true,
    "telemetry_opt_in": true
  }
}
```