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

# Get Settings

> Read the current user's preferences.

## Response

<ResponseField name="default_mode" type="string">
  The default routing mode when `auto` is sent. One of: `auto`, `fast`, `think`, `code`, `research`, `image`, `video`, `roast`.
</ResponseField>

<ResponseField name="personality" type="string">
  Theo personality mode. `"theo"` (default) or `"none"` (neutral).
</ResponseField>

<ResponseField name="timezone" type="string">
  IANA timezone string (e.g., `"America/Guayaquil"`).
</ResponseField>

<ResponseField name="theo_branding" type="boolean">
  When `false`, Theo personality, backstory, mascot emoji, and branded model labels are stripped from API responses. Default: `true`.
</ResponseField>

## Authentication

Requires an API key or a dashboard session.

## Example

```bash curl theme={null}
curl https://www.hitheo.ai/api/v1/settings \
  -H "Authorization: Bearer $THEO_API_KEY"
```

### Response

```json theme={null}
{
  "default_mode": "auto",
  "personality": "theo",
  "timezone": "America/Guayaquil",
  "theo_branding": true
}
```
