Skip to main content
PATCH
/
api
/
v1
/
settings
Update Settings
curl --request PATCH \
  --url https://api.example.com/api/v1/settings \
  --header 'Content-Type: application/json' \
  --data '
{
  "default_mode": "<string>",
  "personality": "<string>",
  "timezone": "<string>",
  "theo_branding": true
}
'

​
Request

​
default_mode
string
Default routing mode. One of: auto, fast, think, code, research, image, video, roast.
​
personality
string
"theo" or "none".
​
timezone
string
Valid IANA timezone string (e.g., "America/New_York").
​
theo_branding
boolean
Enable or disable Theo branding in API responses.

​
Response

Returns the full updated preferences (same shape as GET).

​
Authentication

Requires an API key or a dashboard session. Changes are audited.

​
Example

curl
curl -X PATCH https://www.hitheo.ai/api/v1/settings \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_mode": "code",
    "timezone": "America/New_York"
  }'