Skip to main content
GET
/
api
/
v1
/
settings
Get Settings
curl --request GET \
  --url https://api.example.com/api/v1/settings
{
  "default_mode": "<string>",
  "personality": "<string>",
  "timezone": "<string>",
  "theo_branding": true
}

​
Response

​
default_mode
string
The default routing mode when auto is sent. One of: auto, fast, think, code, research, image, video, roast.
​
personality
string
Theo personality mode. "theo" (default) or "none" (neutral).
​
timezone
string
IANA timezone string (e.g., "America/Guayaquil").
​
theo_branding
boolean
When false, Theo personality, backstory, mascot emoji, and branded model labels are stripped from API responses. Default: true.

​
Authentication

Requires an API key or a dashboard session.

​
Example

curl
curl https://hitheo.ai/api/v1/settings \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

{
  "default_mode": "auto",
  "personality": "theo",
  "timezone": "America/Guayaquil",
  "theo_branding": true
}